/* -*- Mode: javascript; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* vim: set ft=javascript ts=2 et sw=2 tw=80: */ /* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ "use strict"; const { classes: Cc, interfaces: Ci, utils: Cu } = Components; this.EXPORTED_SYMBOLS = [ ]; Cu.import("resource://gre/modules/devtools/gcli.jsm"); Cu.import('resource://gre/modules/XPCOMUtils.jsm'); XPCOMUtils.defineLazyModuleGetter(this, "gDevTools", "resource:///modules/devtools/gDevTools.jsm"); XPCOMUtils.defineLazyModuleGetter(this, "console", "resource://gre/modules/devtools/Console.jsm"); /** * Utility to get access to the current breakpoint list * @param dbg The debugger panel * @returns an array of object, one for each breakpoint, where each breakpoint * object has the following properties: * - id: A unique identifier for the breakpoint. This is not designed to be * shown to the user. * - label: A unique string identifier designed to be user visible. In theory * the label of a breakpoint could change * - url: The URL of the source file * - lineNumber: The line number of the breakpoint in the source file * - lineText: The text of the line at the breakpoint * - truncatedLineText: lineText truncated to MAX_LINE_TEXT_LENGTH */ function getAllBreakpoints(dbg) { let breakpoints = []; let SourceUtils = dbg.panelWin.SourceUtils; for (let source in dbg.panelWin.DebuggerView.Sources) { for (let { attachment: breakpoint } in source) { breakpoints.push({ id: source.value + ":" + breakpoint.lineNumber, label: source.label + ":" + breakpoint.lineNumber, url: source.value, lineNumber: breakpoint.lineNumber, lineText: breakpoint.lineText, truncatedLineText: SourceUtils.trimUrlLength(breakpoint.lineText, MAX_LINE_TEXT_LENGTH, "end") }); } } return breakpoints; } /** * 'break' command */ gcli.addCommand({ name: "break", description: gcli.lookup("breakDesc"), manual: gcli.lookup("breakManual") }); /** * 'break list' command */ gcli.addCommand({ name: "break list", description: gcli.lookup("breaklistDesc"), returnType: "breakpoints", exec: function(args, context) { let dbg = getPanel(context, "jsdebugger", { ensure_opened: true }); return dbg.then(function(dbg) { return getAllBreakpoints(dbg); }); } }); gcli.addConverter({ from: "breakpoints", to: "view", exec: function(breakpoints, context) { let dbg = getPanel(context, "jsdebugger"); if (dbg && breakpoints.length) { return context.createView({ html: breakListHtml, data: { breakpoints: breakpoints, onclick: context.update, ondblclick: context.updateExec } }); } else { return context.createView({ html: "

${message}

", data: { message: gcli.lookup("breaklistNone") } }); } } }); var breakListHtml = "" + "" + " " + " " + " " + " " + " " + " " + " " + " " + " " + " " + " " + " " + "
SourceLineActions
${breakpoint.label}" + " ${breakpoint.truncatedLineText}" + " " + " " + " " + gcli.lookup("breaklistOutRemove") + "" + "
" + ""; var MAX_LINE_TEXT_LENGTH = 30; var MAX_LABEL_LENGTH = 20; /** * 'break add' command */ gcli.addCommand({ name: "break add", description: gcli.lookup("breakaddDesc"), manual: gcli.lookup("breakaddManual") }); /** * 'break add line' command */ gcli.addCommand({ name: "break add line", description: gcli.lookup("breakaddlineDesc"), params: [ { name: "file", type: { name: "selection", data: function(context) { let dbg = getPanel(context, "jsdebugger"); if (dbg) { return dbg.panelWin.DebuggerView.Sources.values; } return []; } }, description: gcli.lookup("breakaddlineFileDesc") }, { name: "line", type: { name: "number", min: 1, step: 10 }, description: gcli.lookup("breakaddlineLineDesc") } ], returnType: "string", exec: function(args, context) { args.type = "line"; let dbg = getPanel(context, "jsdebugger"); if (!dbg) { return gcli.lookup("debuggerStopped"); } let deferred = context.defer(); let position = { url: args.file, line: args.line }; dbg.addBreakpoint(position, function(aBreakpoint, aError) { if (aError) { deferred.resolve(gcli.lookupFormat("breakaddFailed", [aError])); return; } deferred.resolve(gcli.lookup("breakaddAdded")); }); return deferred.promise; } }); /** * 'break del' command */ gcli.addCommand({ name: "break del", description: gcli.lookup("breakdelDesc"), params: [ { name: "breakpoint", type: { name: "selection", lookup: function(context) { let dbg = getPanel(context, "jsdebugger"); if (dbg == null) { return []; } return getAllBreakpoints(dbg).map(breakpoint => { return { name: breakpoint.label, value: breakpoint, description: breakpoint.truncatedLineText }; }); } }, description: gcli.lookup("breakdelBreakidDesc") } ], returnType: "string", exec: function(args, context) { let dbg = getPanel(context, "jsdebugger"); if (!dbg) { return gcli.lookup("debuggerStopped"); } let breakpoint = dbg.getBreakpoint(args.breakpoint.url, args.breakpoint.lineNumber); if (breakpoint == null) { return gcli.lookup("breakNotFound"); } let deferred = context.defer(); try { dbg.removeBreakpoint(breakpoint, function() { deferred.resolve(gcli.lookup("breakdelRemoved")); }); } catch (ex) { console.error('Error removing breakpoint, already removed?', ex); // If the debugger has been closed already, don't scare the user. deferred.resolve(gcli.lookup("breakdelRemoved")); } return deferred.promise; } }); /** * 'dbg' command */ gcli.addCommand({ name: "dbg", description: gcli.lookup("dbgDesc"), manual: gcli.lookup("dbgManual") }); /** * 'dbg open' command */ gcli.addCommand({ name: "dbg open", description: gcli.lookup("dbgOpen"), params: [], exec: function(args, context) { return gDevTools.showToolbox(context.environment.target, "jsdebugger") .then(() => null); } }); /** * 'dbg close' command */ gcli.addCommand({ name: "dbg close", description: gcli.lookup("dbgClose"), params: [], exec: function(args, context) { return gDevTools.closeToolbox(context.environment.target) .then(() => null); } }); /** * 'dbg interrupt' command */ gcli.addCommand({ name: "dbg interrupt", description: gcli.lookup("dbgInterrupt"), params: [], exec: function(args, context) { let dbg = getPanel(context, "jsdebugger"); if (!dbg) { return gcli.lookup("debuggerStopped"); } let controller = dbg._controller; let thread = controller.activeThread; if (!thread.paused) { thread.interrupt(); } } }); /** * 'dbg continue' command */ gcli.addCommand({ name: "dbg continue", description: gcli.lookup("dbgContinue"), params: [], exec: function(args, context) { let dbg = getPanel(context, "jsdebugger"); if (!dbg) { return gcli.lookup("debuggerStopped"); } let controller = dbg._controller; let thread = controller.activeThread; if (thread.paused) { thread.resume(); } } }); /** * 'dbg step' command */ gcli.addCommand({ name: "dbg step", description: gcli.lookup("dbgStepDesc"), manual: gcli.lookup("dbgStepManual") }); /** * 'dbg step over' command */ gcli.addCommand({ name: "dbg step over", description: gcli.lookup("dbgStepOverDesc"), params: [], exec: function(args, context) { let dbg = getPanel(context, "jsdebugger"); if (!dbg) { return gcli.lookup("debuggerStopped"); } let controller = dbg._controller; let thread = controller.activeThread; if (thread.paused) { thread.stepOver(); } } }); /** * 'dbg step in' command */ gcli.addCommand({ name: 'dbg step in', description: gcli.lookup("dbgStepInDesc"), params: [], exec: function(args, context) { let dbg = getPanel(context, "jsdebugger"); if (!dbg) { return gcli.lookup("debuggerStopped"); } let controller = dbg._controller; let thread = controller.activeThread; if (thread.paused) { thread.stepIn(); } } }); /** * 'dbg step over' command */ gcli.addCommand({ name: 'dbg step out', description: gcli.lookup("dbgStepOutDesc"), params: [], exec: function(args, context) { let dbg = getPanel(context, "jsdebugger"); if (!dbg) { return gcli.lookup("debuggerStopped"); } let controller = dbg._controller; let thread = controller.activeThread; if (thread.paused) { thread.stepOut(); } } }); /** * 'dbg list' command */ gcli.addCommand({ name: "dbg list", description: gcli.lookup("dbgListSourcesDesc"), params: [], returnType: "dom", exec: function(args, context) { let dbg = getPanel(context, "jsdebugger"); let doc = context.environment.chromeDocument; if (!dbg) { return gcli.lookup("debuggerClosed"); } let sources = dbg._view.Sources.values; let div = createXHTMLElement(doc, "div"); let ol = createXHTMLElement(doc, "ol"); sources.forEach(function(src) { let li = createXHTMLElement(doc, "li"); li.textContent = src; ol.appendChild(li); }); div.appendChild(ol); return div; } }); /** * A helper to create xhtml namespaced elements */ function createXHTMLElement(document, tagname) { return document.createElementNS("http://www.w3.org/1999/xhtml", tagname); } /** * A helper to go from a command context to a debugger panel */ function getPanel(context, id, options = {}) { if (context == null) { return undefined; } let target = context.environment.target; if (options.ensure_opened) { return gDevTools.showToolbox(target, id).then(function(toolbox) { return toolbox.getPanel(id); }); } else { let toolbox = gDevTools.getToolbox(target); if (toolbox) { return toolbox.getPanel(id); } else { return undefined; } } }