/* Any copyright is dedicated to the Public Domain. http://creativecommons.org/publicdomain/zero/1.0/ */ "use strict"; const { classes: Cc, interfaces: Ci, utils: Cu, results: Cr } = Components; let { Services } = Cu.import("resource://gre/modules/Services.jsm", {}); let { Task } = Cu.import("resource://gre/modules/Task.jsm", {}); let { Promise } = Cu.import("resource://gre/modules/Promise.jsm", {}); let { devtools } = Cu.import("resource://gre/modules/devtools/Loader.jsm", {}); let { gDevTools } = Cu.import("resource:///modules/devtools/gDevTools.jsm", {}); let { DevToolsUtils } = Cu.import("resource://gre/modules/devtools/DevToolsUtils.jsm", {}); let { DebuggerServer } = Cu.import("resource://gre/modules/devtools/dbg-server.jsm", {}); let { merge } = devtools.require("sdk/util/object"); let { getPerformanceActorsConnection, PerformanceFront } = devtools.require("devtools/performance/front"); let nsIProfilerModule = Cc["@mozilla.org/tools/profiler;1"].getService(Ci.nsIProfiler); let TargetFactory = devtools.TargetFactory; let mm = null; const FRAME_SCRIPT_UTILS_URL = "chrome://browser/content/devtools/frame-script-utils.js" const EXAMPLE_URL = "http://example.com/browser/browser/devtools/performance/test/"; const SIMPLE_URL = EXAMPLE_URL + "doc_simple-test.html"; const MEMORY_SAMPLE_PROB_PREF = "devtools.performance.memory.sample-probability"; const MEMORY_MAX_LOG_LEN_PREF = "devtools.performance.memory.max-log-length"; const FRAMERATE_PREF = "devtools.performance.ui.enable-framerate"; const MEMORY_PREF = "devtools.performance.ui.enable-memory"; const PLATFORM_DATA_PREF = "devtools.performance.ui.show-platform-data"; const IDLE_PREF = "devtools.performance.ui.show-idle-blocks"; const INVERT_PREF = "devtools.performance.ui.invert-call-tree"; const INVERT_FLAME_PREF = "devtools.performance.ui.invert-flame-graph"; const FLATTEN_PREF = "devtools.performance.ui.flatten-tree-recursion"; // All tests are asynchronous. waitForExplicitFinish(); gDevTools.testing = true; let DEFAULT_PREFS = [ "devtools.debugger.log", "devtools.performance.ui.invert-call-tree", "devtools.performance.ui.flatten-tree-recursion", "devtools.performance.ui.show-platform-data", "devtools.performance.ui.show-idle-blocks", "devtools.performance.ui.enable-memory", "devtools.performance.ui.enable-framerate", ].reduce((prefs, pref) => { prefs[pref] = Services.prefs.getBoolPref(pref); return prefs; }, {}); // Enable the new performance panel for all tests. Services.prefs.setBoolPref("devtools.performance.enabled", true); // Enable logging for all the tests. Both the debugger server and frontend will // be affected by this pref. Services.prefs.setBoolPref("devtools.debugger.log", false); /** * Call manually in tests that use frame script utils after initializing * the tool. Must be called after initializing so we can detect * whether or not `content` is a CPOW or not. Call after init but before navigating * to different pages. */ function loadFrameScripts () { mm = gBrowser.selectedBrowser.messageManager; mm.loadFrameScript(FRAME_SCRIPT_UTILS_URL, false); } registerCleanupFunction(() => { gDevTools.testing = false; info("finish() was called, cleaning up..."); // Rollback any pref changes Object.keys(DEFAULT_PREFS).forEach(pref => { Services.prefs.setBoolPref(pref, DEFAULT_PREFS[pref]); }); // Make sure the profiler module is stopped when the test finishes. nsIProfilerModule.StopProfiler(); Cu.forceGC(); }); function addTab(aUrl, aWindow) { info("Adding tab: " + aUrl); let deferred = Promise.defer(); let targetWindow = aWindow || window; let targetBrowser = targetWindow.gBrowser; targetWindow.focus(); let tab = targetBrowser.selectedTab = targetBrowser.addTab(aUrl); let linkedBrowser = tab.linkedBrowser; linkedBrowser.addEventListener("load", function onLoad() { linkedBrowser.removeEventListener("load", onLoad, true); info("Tab added and finished loading: " + aUrl); deferred.resolve(tab); }, true); return deferred.promise; } function removeTab(aTab, aWindow) { info("Removing tab."); let deferred = Promise.defer(); let targetWindow = aWindow || window; let targetBrowser = targetWindow.gBrowser; let tabContainer = targetBrowser.tabContainer; tabContainer.addEventListener("TabClose", function onClose(aEvent) { tabContainer.removeEventListener("TabClose", onClose, false); info("Tab removed and finished closing."); deferred.resolve(); }, false); targetBrowser.removeTab(aTab); return deferred.promise; } function handleError(aError) { ok(false, "Got an error: " + aError.message + "\n" + aError.stack); finish(); } function once(aTarget, aEventName, aUseCapture = false, spread = false) { info("Waiting for event: '" + aEventName + "' on " + aTarget + "."); let deferred = Promise.defer(); for (let [add, remove] of [ ["on", "off"], // Use event emitter before DOM events for consistency ["addEventListener", "removeEventListener"], ["addListener", "removeListener"] ]) { if ((add in aTarget) && (remove in aTarget)) { aTarget[add](aEventName, function onEvent(...aArgs) { aTarget[remove](aEventName, onEvent, aUseCapture); deferred.resolve(spread ? aArgs : aArgs[0]); }, aUseCapture); break; } } return deferred.promise; } /** * Like `once`, except returns an array so we can * access all arguments fired by the event. */ function onceSpread(aTarget, aEventName, aUseCapture) { return once(aTarget, aEventName, aUseCapture, true); } function test () { Task.spawn(spawnTest).then(finish, handleError); } function initBackend(aUrl, targetOps={}) { info("Initializing a performance front."); if (!DebuggerServer.initialized) { DebuggerServer.init(); DebuggerServer.addBrowserActors(); } return Task.spawn(function*() { let tab = yield addTab(aUrl); let target = TargetFactory.forTab(tab); yield target.makeRemote(); // Attach addition options to `target`. This is used to force mock fronts // to smokescreen test different servers where memory or timeline actors // may not exist. Possible options that will actually work: // TEST_MOCK_MEMORY_ACTOR = true // TEST_MOCK_TIMELINE_ACTOR = true merge(target, targetOps); yield gDevTools.showToolbox(target, "performance"); let connection = getPerformanceActorsConnection(target); yield connection.open(); let front = new PerformanceFront(connection); return { target, front }; }); } function initPerformance(aUrl, selectedTool="performance", targetOps={}) { info("Initializing a performance pane."); return Task.spawn(function*() { let tab = yield addTab(aUrl); let target = TargetFactory.forTab(tab); yield target.makeRemote(); // Attach addition options to `target`. This is used to force mock fronts // to smokescreen test different servers where memory or timeline actors // may not exist. Possible options that will actually work: // TEST_MOCK_MEMORY_ACTOR = true // TEST_MOCK_TIMELINE_ACTOR = true merge(target, targetOps); let toolbox = yield gDevTools.showToolbox(target, selectedTool); let panel = toolbox.getCurrentPanel(); return { target, panel, toolbox }; }); } function* teardown(panel) { info("Destroying the performance tool."); let tab = panel.target.tab; yield panel._toolbox.destroy(); yield removeTab(tab); } function idleWait(time) { return DevToolsUtils.waitForTime(time); } function busyWait(time) { let start = Date.now(); let stack; while (Date.now() - start < time) { stack = Components.stack; } } function consoleMethod (...args) { if (!mm) { throw new Error("`loadFrameScripts()` must be called before using frame scripts."); } mm.sendAsyncMessage("devtools:test:console", args); } function* consoleProfile(connection, label) { let notified = connection.once("profile"); consoleMethod("profile", label); yield notified; } function* consoleProfileEnd(connection) { let notified = connection.once("profileEnd"); consoleMethod("profileEnd"); yield notified; } function command (button) { let ev = button.ownerDocument.createEvent("XULCommandEvent"); ev.initCommandEvent("command", true, true, button.ownerDocument.defaultView, 0, false, false, false, false, null); button.dispatchEvent(ev); } function click (win, button) { EventUtils.sendMouseEvent({ type: "click" }, button, win); } function mousedown (win, button) { EventUtils.sendMouseEvent({ type: "mousedown" }, button, win); } function* startRecording(panel, options = { waitForOverview: true, waitForStateChanged: true }) { let win = panel.panelWin; let clicked = panel.panelWin.PerformanceView.once(win.EVENTS.UI_START_RECORDING); let willStart = panel.panelWin.PerformanceController.once(win.EVENTS.RECORDING_WILL_START); let hasStarted = panel.panelWin.PerformanceController.once(win.EVENTS.RECORDING_STARTED); let button = win.$("#main-record-button"); ok(!button.hasAttribute("checked"), "The record button should not be checked yet."); ok(!button.hasAttribute("locked"), "The record button should not be locked yet."); click(win, button); yield clicked; ok(button.hasAttribute("checked"), "The record button should now be checked."); ok(button.hasAttribute("locked"), "The record button should be locked."); yield willStart; let stateChanged = options.waitForStateChanged ? once(win.PerformanceView, win.EVENTS.UI_STATE_CHANGED) : Promise.resolve(); yield hasStarted; let overviewRendered = options.waitForOverview ? once(win.OverviewView, win.EVENTS.OVERVIEW_RENDERED) : Promise.resolve(); yield stateChanged; yield overviewRendered; is(win.PerformanceView.getState(), "recording", "The current state is 'recording'."); ok(button.hasAttribute("checked"), "The record button should still be checked."); ok(!button.hasAttribute("locked"), "The record button should not be locked."); } function* stopRecording(panel, options = { waitForOverview: true, waitForStateChanged: true }) { let win = panel.panelWin; let clicked = panel.panelWin.PerformanceView.once(win.EVENTS.UI_STOP_RECORDING); let willStop = panel.panelWin.PerformanceController.once(win.EVENTS.RECORDING_WILL_STOP); let hasStopped = panel.panelWin.PerformanceController.once(win.EVENTS.RECORDING_STOPPED); let button = win.$("#main-record-button"); ok(button.hasAttribute("checked"), "The record button should already be checked."); ok(!button.hasAttribute("locked"), "The record button should not be locked yet."); click(win, button); yield clicked; ok(!button.hasAttribute("checked"), "The record button should not be checked."); ok(button.hasAttribute("locked"), "The record button should be locked."); yield willStop; let stateChanged = options.waitForStateChanged ? once(win.PerformanceView, win.EVENTS.UI_STATE_CHANGED) : Promise.resolve(); yield hasStopped; let overviewRendered = options.waitForOverview ? once(win.OverviewView, win.EVENTS.OVERVIEW_RENDERED) : Promise.resolve(); yield stateChanged; yield overviewRendered; is(win.PerformanceView.getState(), "recorded", "The current state is 'recorded'."); ok(!button.hasAttribute("checked"), "The record button should not be checked."); ok(!button.hasAttribute("locked"), "The record button should not be locked."); } function waitForWidgetsRendered(panel) { let { EVENTS, OverviewView, WaterfallView, JsCallTreeView, JsFlameGraphView, MemoryCallTreeView, MemoryFlameGraphView, } = panel.panelWin; return Promise.all([ once(OverviewView, EVENTS.MARKERS_GRAPH_RENDERED), once(OverviewView, EVENTS.MEMORY_GRAPH_RENDERED), once(OverviewView, EVENTS.FRAMERATE_GRAPH_RENDERED), once(OverviewView, EVENTS.OVERVIEW_RENDERED), once(WaterfallView, EVENTS.WATERFALL_RENDERED), once(JsCallTreeView, EVENTS.JS_CALL_TREE_RENDERED), once(JsFlameGraphView, EVENTS.JS_FLAMEGRAPH_RENDERED), once(MemoryCallTreeView, EVENTS.MEMORY_CALL_TREE_RENDERED), once(MemoryFlameGraphView, EVENTS.MEMORY_FLAMEGRAPH_RENDERED), ]); } /** * Waits until a predicate returns true. * * @param function predicate * Invoked once in a while until it returns true. * @param number interval [optional] * How often the predicate is invoked, in milliseconds. */ function waitUntil(predicate, interval = 10) { if (predicate()) { return Promise.resolve(true); } let deferred = Promise.defer(); setTimeout(function() { waitUntil(predicate).then(() => deferred.resolve(true)); }, interval); return deferred.promise; } // EventUtils just doesn't work! function dragStart(graph, x, y = 1) { x /= window.devicePixelRatio; y /= window.devicePixelRatio; graph._onMouseMove({ clientX: x, clientY: y }); graph._onMouseDown({ clientX: x, clientY: y }); } function dragStop(graph, x, y = 1) { x /= window.devicePixelRatio; y /= window.devicePixelRatio; graph._onMouseMove({ clientX: x, clientY: y }); graph._onMouseUp({ clientX: x, clientY: y }); } function dropSelection(graph) { graph.dropSelection(); graph.emit("selecting"); } function getSourceActor(aSources, aURL) { let item = aSources.getItemForAttachment(a => a.source.url === aURL); return item && item.value; } /** * Fires a key event, like "VK_UP", "VK_DOWN", etc. */ function fireKey (e) { EventUtils.synthesizeKey(e, {}); } function reload (aTarget, aEvent = "navigate") { aTarget.activeTab.reload(); return once(aTarget, aEvent); }