/* -*- 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"; // A time interval sufficient for the options popup panel to finish hiding // itself. const POPUP_HIDDEN_DELAY = 100; // ms /** * Functions handling the toolbar view: close button, expand/collapse button, * pause/resume and stepping buttons etc. */ function ToolbarView() { dumpn("ToolbarView was instantiated"); this._onTogglePanesPressed = this._onTogglePanesPressed.bind(this); this._onResumePressed = this._onResumePressed.bind(this); this._onStepOverPressed = this._onStepOverPressed.bind(this); this._onStepInPressed = this._onStepInPressed.bind(this); this._onStepOutPressed = this._onStepOutPressed.bind(this); } ToolbarView.prototype = { /** * Initialization function, called when the debugger is started. */ initialize: function() { dumpn("Initializing the ToolbarView"); this._instrumentsPaneToggleButton = document.getElementById("instruments-pane-toggle"); this._resumeOrderPanel = document.getElementById("resumption-order-panel"); this._resumeButton = document.getElementById("resume"); this._stepOverButton = document.getElementById("step-over"); this._stepInButton = document.getElementById("step-in"); this._stepOutButton = document.getElementById("step-out"); this._chromeGlobals = document.getElementById("chrome-globals"); let resumeKey = LayoutHelpers.prettyKey(document.getElementById("resumeKey"), true); let stepOverKey = LayoutHelpers.prettyKey(document.getElementById("stepOverKey"), true); let stepInKey = LayoutHelpers.prettyKey(document.getElementById("stepInKey"), true); let stepOutKey = LayoutHelpers.prettyKey(document.getElementById("stepOutKey"), true); this._resumeTooltip = L10N.getFormatStr("resumeButtonTooltip", resumeKey); this._pauseTooltip = L10N.getFormatStr("pauseButtonTooltip", resumeKey); this._stepOverTooltip = L10N.getFormatStr("stepOverTooltip", stepOverKey); this._stepInTooltip = L10N.getFormatStr("stepInTooltip", stepInKey); this._stepOutTooltip = L10N.getFormatStr("stepOutTooltip", stepOutKey); this._instrumentsPaneToggleButton.addEventListener("mousedown", this._onTogglePanesPressed, false); this._resumeButton.addEventListener("mousedown", this._onResumePressed, false); this._stepOverButton.addEventListener("mousedown", this._onStepOverPressed, false); this._stepInButton.addEventListener("mousedown", this._onStepInPressed, false); this._stepOutButton.addEventListener("mousedown", this._onStepOutPressed, false); this._stepOverButton.setAttribute("tooltiptext", this._stepOverTooltip); this._stepInButton.setAttribute("tooltiptext", this._stepInTooltip); this._stepOutButton.setAttribute("tooltiptext", this._stepOutTooltip); // TODO: bug 806775 - group scripts by globals using hostAnnotations. // this.toggleChromeGlobalsContainer(window._isChromeDebugger); }, /** * Destruction function, called when the debugger is closed. */ destroy: function() { dumpn("Destroying the ToolbarView"); this._instrumentsPaneToggleButton.removeEventListener("mousedown", this._onTogglePanesPressed, false); this._resumeButton.removeEventListener("mousedown", this._onResumePressed, false); this._stepOverButton.removeEventListener("mousedown", this._onStepOverPressed, false); this._stepInButton.removeEventListener("mousedown", this._onStepInPressed, false); this._stepOutButton.removeEventListener("mousedown", this._onStepOutPressed, false); }, /** * Display a warning when trying to resume a debuggee while another is paused. * Debuggees must be unpaused in a Last-In-First-Out order. * * @param string aPausedUrl * The URL of the last paused debuggee. */ showResumeWarning: function(aPausedUrl) { let label = L10N.getFormatStr("resumptionOrderPanelTitle", aPausedUrl); let descriptionNode = document.getElementById("resumption-panel-desc"); descriptionNode.setAttribute("value", label); this._resumeOrderPanel.openPopup(this._resumeButton); }, /** * Sets the resume button state based on the debugger active thread. * * @param string aState * Either "paused" or "attached". */ toggleResumeButtonState: function(aState) { // If we're paused, check and show a resume label on the button. if (aState == "paused") { this._resumeButton.setAttribute("checked", "true"); this._resumeButton.setAttribute("tooltiptext", this._resumeTooltip); } // If we're attached, do the opposite. else if (aState == "attached") { this._resumeButton.removeAttribute("checked"); this._resumeButton.setAttribute("tooltiptext", this._pauseTooltip); } }, /** * Sets the chrome globals container hidden or visible. It's hidden by default. * * @param boolean aVisibleFlag * Specifies the intended visibility. */ toggleChromeGlobalsContainer: function(aVisibleFlag) { this._chromeGlobals.setAttribute("hidden", !aVisibleFlag); }, /** * Listener handling the toggle button click event. */ _onTogglePanesPressed: function() { DebuggerView.toggleInstrumentsPane({ visible: DebuggerView.instrumentsPaneHidden, animated: true, delayed: true }); }, /** * Listener handling the pause/resume button click event. */ _onResumePressed: function() { if (DebuggerController.activeThread.paused) { let warn = DebuggerController._ensureResumptionOrder; DebuggerController.activeThread.resume(warn); } else { DebuggerController.activeThread.interrupt(); } }, /** * Listener handling the step over button click event. */ _onStepOverPressed: function() { if (DebuggerController.activeThread.paused) { DebuggerController.activeThread.stepOver(); } }, /** * Listener handling the step in button click event. */ _onStepInPressed: function() { if (DebuggerController.activeThread.paused) { DebuggerController.activeThread.stepIn(); } }, /** * Listener handling the step out button click event. */ _onStepOutPressed: function() { if (DebuggerController.activeThread.paused) { DebuggerController.activeThread.stepOut(); } }, _instrumentsPaneToggleButton: null, _resumeOrderPanel: null, _resumeButton: null, _stepOverButton: null, _stepInButton: null, _stepOutButton: null, _chromeGlobals: null, _resumeTooltip: "", _pauseTooltip: "", _stepOverTooltip: "", _stepInTooltip: "", _stepOutTooltip: "" }; /** * Functions handling the options UI. */ function OptionsView() { dumpn("OptionsView was instantiated"); this._togglePauseOnExceptions = this._togglePauseOnExceptions.bind(this); this._toggleShowPanesOnStartup = this._toggleShowPanesOnStartup.bind(this); this._toggleShowVariablesOnlyEnum = this._toggleShowVariablesOnlyEnum.bind(this); this._toggleShowVariablesFilterBox = this._toggleShowVariablesFilterBox.bind(this); this._toggleShowOriginalSource = this._toggleShowOriginalSource.bind(this); } OptionsView.prototype = { /** * Initialization function, called when the debugger is started. */ initialize: function() { dumpn("Initializing the OptionsView"); this._button = document.getElementById("debugger-options"); this._pauseOnExceptionsItem = document.getElementById("pause-on-exceptions"); this._showPanesOnStartupItem = document.getElementById("show-panes-on-startup"); this._showVariablesOnlyEnumItem = document.getElementById("show-vars-only-enum"); this._showVariablesFilterBoxItem = document.getElementById("show-vars-filter-box"); this._showOriginalSourceItem = document.getElementById("show-original-source"); this._pauseOnExceptionsItem.setAttribute("checked", Prefs.pauseOnExceptions); this._showPanesOnStartupItem.setAttribute("checked", Prefs.panesVisibleOnStartup); this._showVariablesOnlyEnumItem.setAttribute("checked", Prefs.variablesOnlyEnumVisible); this._showVariablesFilterBoxItem.setAttribute("checked", Prefs.variablesSearchboxVisible); this._showOriginalSourceItem.setAttribute("checked", Prefs.sourceMapsEnabled); }, /** * Destruction function, called when the debugger is closed. */ destroy: function() { dumpn("Destroying the OptionsView"); // Nothing to do here yet. }, /** * Listener handling the 'gear menu' popup showing event. */ _onPopupShowing: function() { this._button.setAttribute("open", "true"); }, /** * Listener handling the 'gear menu' popup hiding event. */ _onPopupHiding: function() { this._button.removeAttribute("open"); }, /** * Listener handling the 'gear menu' popup hidden event. */ _onPopupHidden: function() { window.dispatchEvent(document, "Debugger:OptionsPopupHidden"); }, /** * Listener handling the 'pause on exceptions' menuitem command. */ _togglePauseOnExceptions: function() { let pref = Prefs.pauseOnExceptions = this._pauseOnExceptionsItem.getAttribute("checked") == "true"; DebuggerController.activeThread.pauseOnExceptions(pref); }, /** * Listener handling the 'show panes on startup' menuitem command. */ _toggleShowPanesOnStartup: function() { Prefs.panesVisibleOnStartup = this._showPanesOnStartupItem.getAttribute("checked") == "true"; }, /** * Listener handling the 'show non-enumerables' menuitem command. */ _toggleShowVariablesOnlyEnum: function() { let pref = Prefs.variablesOnlyEnumVisible = this._showVariablesOnlyEnumItem.getAttribute("checked") == "true"; DebuggerView.Variables.onlyEnumVisible = pref; }, /** * Listener handling the 'show variables searchbox' menuitem command. */ _toggleShowVariablesFilterBox: function() { let pref = Prefs.variablesSearchboxVisible = this._showVariablesFilterBoxItem.getAttribute("checked") == "true"; DebuggerView.Variables.searchEnabled = pref; }, /** * Listener handling the 'show original source' menuitem command. */ _toggleShowOriginalSource: function() { function reconfigure() { window.removeEventListener("Debugger:OptionsPopupHidden", reconfigure, false); // The popup panel needs more time to hide after triggering onpopuphidden. window.setTimeout(function() { DebuggerController.reconfigureThread(pref); }, POPUP_HIDDEN_DELAY); } let pref = Prefs.sourceMapsEnabled = this._showOriginalSourceItem.getAttribute("checked") == "true"; // Don't block the UI while reconfiguring the server. window.addEventListener("Debugger:OptionsPopupHidden", reconfigure, false); }, _button: null, _pauseOnExceptionsItem: null, _showPanesOnStartupItem: null, _showVariablesOnlyEnumItem: null, _showVariablesFilterBoxItem: null, _showOriginalSourceItem: null }; /** * Functions handling the chrome globals UI. */ function ChromeGlobalsView() { dumpn("ChromeGlobalsView was instantiated"); this._onSelect = this._onSelect.bind(this); this._onClick = this._onClick.bind(this); } ChromeGlobalsView.prototype = Heritage.extend(WidgetMethods, { /** * Initialization function, called when the debugger is started. */ initialize: function() { dumpn("Initializing the ChromeGlobalsView"); this.widget = document.getElementById("chrome-globals"); this.emptyText = L10N.getStr("noGlobalsText"); this.unavailableText = L10N.getStr("noMatchingGlobalsText"); this.widget.addEventListener("select", this._onSelect, false); this.widget.addEventListener("click", this._onClick, false); // Show an empty label by default. this.empty(); }, /** * Destruction function, called when the debugger is closed. */ destroy: function() { dumpn("Destroying the ChromeGlobalsView"); this.widget.removeEventListener("select", this._onSelect, false); this.widget.removeEventListener("click", this._onClick, false); }, /** * The select listener for the chrome globals container. */ _onSelect: function() { // TODO: bug 806775, do something useful for chrome debugging. }, /** * The click listener for the chrome globals container. */ _onClick: function() { // Use this container as a filtering target. DebuggerView.Filtering.target = this; } }); /** * Functions handling the stackframes UI. */ function StackFramesView() { dumpn("StackFramesView was instantiated"); this._onStackframeRemoved = this._onStackframeRemoved.bind(this); this._onSelect = this._onSelect.bind(this); this._onScroll = this._onScroll.bind(this); this._afterScroll = this._afterScroll.bind(this); } StackFramesView.prototype = Heritage.extend(WidgetMethods, { /** * Initialization function, called when the debugger is started. */ initialize: function() { dumpn("Initializing the StackFramesView"); let commandset = this._commandset = document.createElement("commandset"); let menupopup = this._menupopup = document.createElement("menupopup"); commandset.id = "stackframesCommandset"; menupopup.id = "stackframesMenupopup"; document.getElementById("debuggerPopupset").appendChild(menupopup); document.getElementById("debuggerCommands").appendChild(commandset); this.widget = new BreadcrumbsWidget(document.getElementById("stackframes")); this.widget.addEventListener("select", this._onSelect, false); this.widget.addEventListener("scroll", this._onScroll, true); window.addEventListener("resize", this._onScroll, true); this.autoFocusOnFirstItem = false; this.autoFocusOnSelection = false; }, /** * Destruction function, called when the debugger is closed. */ destroy: function() { dumpn("Destroying the StackFramesView"); this.widget.removeEventListener("select", this._onSelect, false); this.widget.removeEventListener("scroll", this._onScroll, true); window.removeEventListener("resize", this._onScroll, true); }, /** * Adds a frame in this stackframes container. * * @param string aFrameTitle * The frame title to be displayed in the list. * @param string aSourceLocation * The source location to be displayed in the list. * @param string aLineNumber * The line number to be displayed in the list. * @param number aDepth * The frame depth specified by the debugger. */ addFrame: function(aFrameTitle, aSourceLocation, aLineNumber, aDepth) { // Create the element node and menu entry for the stack frame item. let frameView = this._createFrameView.apply(this, arguments); let menuEntry = this._createMenuEntry.apply(this, arguments); // Append a stack frame item to this container. this.push([frameView], { index: 0, /* specifies on which position should the item be appended */ attachment: { popup: menuEntry, depth: aDepth }, attributes: [ ["contextmenu", "stackframesMenupopup"], ["tooltiptext", aSourceLocation] ], // Make sure that when the stack frame item is removed, the corresponding // menuitem and command are also destroyed. finalize: this._onStackframeRemoved }); }, /** * Selects the frame at the specified depth in this container. * @param number aDepth */ set selectedDepth(aDepth) { this.selectedItem = (aItem) => aItem.attachment.depth == aDepth; }, /** * Specifies if the active thread has more frames that need to be loaded. */ dirty: false, /** * Customization function for creating an item's UI. * * @param string aFrameTitle * The frame title to be displayed in the list. * @param string aSourceLocation * The source location to be displayed in the list. * @param string aLineNumber * The line number to be displayed in the list. * @param number aDepth * The frame depth specified by the debugger. * @return nsIDOMNode * The stack frame view. */ _createFrameView: function(aFrameTitle, aSourceLocation, aLineNumber, aDepth) { let frameDetails = SourceUtils.trimUrlLength( SourceUtils.getSourceLabel(aSourceLocation), STACK_FRAMES_SOURCE_URL_MAX_LENGTH, STACK_FRAMES_SOURCE_URL_TRIM_SECTION) + SEARCH_LINE_FLAG + aLineNumber; let frameTitleNode = document.createElement("label"); frameTitleNode.className = "plain dbg-stackframe-title breadcrumbs-widget-item-tag"; frameTitleNode.setAttribute("value", aFrameTitle); let frameDetailsNode = document.createElement("label"); frameDetailsNode.className = "plain dbg-stackframe-details breadcrumbs-widget-item-id"; frameDetailsNode.setAttribute("value", frameDetails); let container = document.createElement("hbox"); container.id = "stackframe-" + aDepth; container.className = "dbg-stackframe"; container.appendChild(frameTitleNode); container.appendChild(frameDetailsNode); return container; }, /** * Customization function for populating an item's context menu. * * @param string aFrameTitle * The frame title to be displayed in the list. * @param string aSourceLocation * The source location to be displayed in the list. * @param string aLineNumber * The line number to be displayed in the list. * @param number aDepth * The frame depth specified by the debugger. * @return object * An object containing the stack frame command and menu item. */ _createMenuEntry: function(aFrameTitle, aSourceLocation, aLineNumber, aDepth) { let frameDescription = SourceUtils.trimUrlLength( SourceUtils.getSourceLabel(aSourceLocation), STACK_FRAMES_POPUP_SOURCE_URL_MAX_LENGTH, STACK_FRAMES_POPUP_SOURCE_URL_TRIM_SECTION) + SEARCH_LINE_FLAG + aLineNumber; let prefix = "sf-cMenu-"; // "stackframes context menu" let commandId = prefix + aDepth + "-" + "-command"; let menuitemId = prefix + aDepth + "-" + "-menuitem"; let command = document.createElement("command"); command.id = commandId; command.addEventListener("command", () => this.selectedDepth = aDepth, false); let menuitem = document.createElement("menuitem"); menuitem.id = menuitemId; menuitem.className = "dbg-stackframe-menuitem"; menuitem.setAttribute("type", "checkbox"); menuitem.setAttribute("command", commandId); menuitem.setAttribute("tooltiptext", aSourceLocation); let labelNode = document.createElement("label"); labelNode.className = "plain dbg-stackframe-menuitem-title"; labelNode.setAttribute("value", aFrameTitle); labelNode.setAttribute("flex", "1"); let descriptionNode = document.createElement("label"); descriptionNode.className = "plain dbg-stackframe-menuitem-details"; descriptionNode.setAttribute("value", frameDescription); menuitem.appendChild(labelNode); menuitem.appendChild(descriptionNode); this._commandset.appendChild(command); this._menupopup.appendChild(menuitem); return { command: command, menuitem: menuitem }; }, /** * Function called each time a stack frame item is removed. * * @param object aItem * The corresponding item. */ _onStackframeRemoved: function(aItem) { dumpn("Finalizing stackframe item: " + aItem); // Destroy the context menu item for the stack frame. let contextItem = aItem.attachment.popup; contextItem.command.remove(); contextItem.menuitem.remove(); }, /** * The select listener for the stackframes container. */ _onSelect: function(e) { let stackframeItem = this.selectedItem; if (stackframeItem) { // The container is not empty and an actual item was selected. gStackFrames.selectFrame(stackframeItem.attachment.depth); // Update the context menu to show the currently selected stackframe item // as a checked entry. for (let otherItem in this) { if (otherItem != stackframeItem) { otherItem.attachment.popup.menuitem.removeAttribute("checked"); } else { otherItem.attachment.popup.menuitem.setAttribute("checked", ""); } } } }, /** * The scroll listener for the stackframes container. */ _onScroll: function() { // Update the stackframes container only if we have to. if (!this.dirty) { return; } window.clearTimeout(this._scrollTimeout); this._scrollTimeout = window.setTimeout(this._afterScroll, STACK_FRAMES_SCROLL_DELAY); }, /** * Requests the addition of more frames from the controller. */ _afterScroll: function() { // TODO: Accessing private widget properties. Figure out what's the best // way to expose such things. Bug 876271. let list = this.widget._list; let scrollPosition = list.scrollPosition; let scrollWidth = list.scrollWidth; // If the stackframes container scrolled almost to the end, with only // 1/10 of a breadcrumb remaining, load more content. if (scrollPosition - scrollWidth / 10 < 1) { list.ensureElementIsVisible(this.getItemAtIndex(CALL_STACK_PAGE_SIZE - 1).target); this.dirty = false; // Loads more stack frames from the debugger server cache. DebuggerController.StackFrames.addMoreFrames(); } }, _commandset: null, _menupopup: null, _scrollTimeout: null }); /** * Utility functions for handling stackframes. */ let StackFrameUtils = { /** * Create a textual representation for the specified stack frame * to display in the stackframes container. * * @param object aFrame * The stack frame to label. */ getFrameTitle: function(aFrame) { if (aFrame.type == "call") { let c = aFrame.callee; return (c.name || c.userDisplayName || c.displayName || "(anonymous)"); } return "(" + aFrame.type + ")"; }, /** * Constructs a scope label based on its environment. * * @param object aEnv * The scope's environment. * @return string * The scope's label. */ getScopeLabel: function(aEnv) { let name = ""; // Name the outermost scope Global. if (!aEnv.parent) { name = L10N.getStr("globalScopeLabel"); } // Otherwise construct the scope name. else { name = aEnv.type.charAt(0).toUpperCase() + aEnv.type.slice(1); } let label = L10N.getFormatStr("scopeLabel", name); switch (aEnv.type) { case "with": case "object": label += " [" + aEnv.object.class + "]"; break; case "function": let f = aEnv.function; label += " [" + (f.name || f.userDisplayName || f.displayName || "(anonymous)") + "]"; break; } return label; } }; /** * Functions handling the filtering UI. */ function FilterView() { dumpn("FilterView was instantiated"); this._onClick = this._onClick.bind(this); this._onSearch = this._onSearch.bind(this); this._onKeyPress = this._onKeyPress.bind(this); this._onBlur = this._onBlur.bind(this); } FilterView.prototype = { /** * Initialization function, called when the debugger is started. */ initialize: function() { dumpn("Initializing the FilterView"); this._searchbox = document.getElementById("searchbox"); this._searchboxHelpPanel = document.getElementById("searchbox-help-panel"); this._globalOperatorButton = document.getElementById("global-operator-button"); this._globalOperatorLabel = document.getElementById("global-operator-label"); this._functionOperatorButton = document.getElementById("function-operator-button"); this._functionOperatorLabel = document.getElementById("function-operator-label"); this._tokenOperatorButton = document.getElementById("token-operator-button"); this._tokenOperatorLabel = document.getElementById("token-operator-label"); this._lineOperatorButton = document.getElementById("line-operator-button"); this._lineOperatorLabel = document.getElementById("line-operator-label"); this._variableOperatorButton = document.getElementById("variable-operator-button"); this._variableOperatorLabel = document.getElementById("variable-operator-label"); this._fileSearchKey = LayoutHelpers.prettyKey(document.getElementById("fileSearchKey"), true); this._globalSearchKey = LayoutHelpers.prettyKey(document.getElementById("globalSearchKey"), true); this._filteredFunctionsKey = LayoutHelpers.prettyKey(document.getElementById("functionSearchKey"), true); this._tokenSearchKey = LayoutHelpers.prettyKey(document.getElementById("tokenSearchKey"), true); this._lineSearchKey = LayoutHelpers.prettyKey(document.getElementById("lineSearchKey"), true); this._variableSearchKey = LayoutHelpers.prettyKey(document.getElementById("variableSearchKey"), true); this._searchbox.addEventListener("click", this._onClick, false); this._searchbox.addEventListener("select", this._onSearch, false); this._searchbox.addEventListener("input", this._onSearch, false); this._searchbox.addEventListener("keypress", this._onKeyPress, false); this._searchbox.addEventListener("blur", this._onBlur, false); this._globalOperatorButton.setAttribute("label", SEARCH_GLOBAL_FLAG); this._functionOperatorButton.setAttribute("label", SEARCH_FUNCTION_FLAG); this._tokenOperatorButton.setAttribute("label", SEARCH_TOKEN_FLAG); this._lineOperatorButton.setAttribute("label", SEARCH_LINE_FLAG); this._variableOperatorButton.setAttribute("label", SEARCH_VARIABLE_FLAG); this._globalOperatorLabel.setAttribute("value", L10N.getFormatStr("searchPanelGlobal", this._globalSearchKey)); this._functionOperatorLabel.setAttribute("value", L10N.getFormatStr("searchPanelFunction", this._filteredFunctionsKey)); this._tokenOperatorLabel.setAttribute("value", L10N.getFormatStr("searchPanelToken", this._tokenSearchKey)); this._lineOperatorLabel.setAttribute("value", L10N.getFormatStr("searchPanelLine", this._lineSearchKey)); this._variableOperatorLabel.setAttribute("value", L10N.getFormatStr("searchPanelVariable", this._variableSearchKey)); // TODO: bug 806775 - group scripts by globals using hostAnnotations. // if (window._isChromeDebugger) { // this.target = DebuggerView.ChromeGlobals; // } else { this.target = DebuggerView.Sources; // } }, /** * Destruction function, called when the debugger is closed. */ destroy: function() { dumpn("Destroying the FilterView"); this._searchbox.removeEventListener("click", this._onClick, false); this._searchbox.removeEventListener("select", this._onSearch, false); this._searchbox.removeEventListener("input", this._onSearch, false); this._searchbox.removeEventListener("keypress", this._onKeyPress, false); this._searchbox.removeEventListener("blur", this._onBlur, false); }, /** * Sets the target container to be currently filtered. * @param object aView */ set target(aView) { let placeholder = ""; switch (aView) { case DebuggerView.ChromeGlobals: placeholder = L10N.getFormatStr("emptyChromeGlobalsFilterText", this._fileSearchKey); break; case DebuggerView.Sources: placeholder = L10N.getFormatStr("emptyFilterText", this._fileSearchKey); break; } this._searchbox.setAttribute("placeholder", placeholder); this._target = aView; }, /** * Gets the target container to be currently filtered. * @return object */ get target() this._target, /** * Gets the entered file, line and token entered in the searchbox. * @return array */ get searchboxInfo() { let operator, file, line, token; let rawValue = this._searchbox.value; let rawLength = rawValue.length; let globalFlagIndex = rawValue.indexOf(SEARCH_GLOBAL_FLAG); let functionFlagIndex = rawValue.indexOf(SEARCH_FUNCTION_FLAG); let variableFlagIndex = rawValue.indexOf(SEARCH_VARIABLE_FLAG); let lineFlagIndex = rawValue.lastIndexOf(SEARCH_LINE_FLAG); let tokenFlagIndex = rawValue.lastIndexOf(SEARCH_TOKEN_FLAG); // This is not a global, function or variable search, allow file/line flags. if (globalFlagIndex != 0 && functionFlagIndex != 0 && variableFlagIndex != 0) { let fileEnd = lineFlagIndex != -1 ? lineFlagIndex : tokenFlagIndex != -1 ? tokenFlagIndex : rawLength; let lineEnd = tokenFlagIndex != -1 ? tokenFlagIndex : rawLength; operator = ""; file = rawValue.slice(0, fileEnd); line = ~~(rawValue.slice(fileEnd + 1, lineEnd)) || 0; token = rawValue.slice(lineEnd + 1); } // Global searches dissalow the use of file or line flags. else if (globalFlagIndex == 0) { operator = SEARCH_GLOBAL_FLAG; file = ""; line = 0; token = rawValue.slice(1); } // Function searches dissalow the use of file or line flags. else if (functionFlagIndex == 0) { operator = SEARCH_FUNCTION_FLAG; file = ""; line = 0; token = rawValue.slice(1); } // Variable searches dissalow the use of file or line flags. else if (variableFlagIndex == 0) { operator = SEARCH_VARIABLE_FLAG; file = ""; line = 0; token = rawValue.slice(1); } return [operator, file, line, token]; }, /** * Returns the current searched operator. * @return string */ get currentOperator() this.searchboxInfo[0], /** * Returns the currently searched file. * @return string */ get searchedFile() this.searchboxInfo[1], /** * Returns the currently searched line. * @return number */ get searchedLine() this.searchboxInfo[2], /** * Returns the currently searched token. * @return string */ get searchedToken() this.searchboxInfo[3], /** * Clears the text from the searchbox and resets any changed view. */ clearSearch: function() { this._searchbox.value = ""; this._searchboxHelpPanel.hidePopup(); }, /** * Performs a file search if necessary. * * @param string aFile * The source location to search for. */ _performFileSearch: function(aFile) { // Don't search for files if the input hasn't changed. if (this._prevSearchedFile == aFile) { return; } // This is the target container to be currently filtered. Clicking on a // container generally means it should become a target. let view = this._target; // If we're not searching for a file anymore, unhide all the items. if (!aFile) { for (let item in view) { item.target.hidden = false; } view.refresh(); } // If the searched file string is valid, hide non-matched items. else { let found = false; let lowerCaseFile = aFile.toLowerCase(); for (let item in view) { let element = item.target; let lowerCaseLabel = item.label.toLowerCase(); // Search is not case sensitive, and is tied to the label not the value. if (lowerCaseLabel.match(lowerCaseFile)) { element.hidden = false; // Automatically select the first match. if (!found) { found = true; view.selectedItem = item; view.refresh(); } } // Item not matched, hide the corresponding node. else { element.hidden = true; } } // If no matches were found, display the appropriate info. if (!found) { view.setUnavailable(); } } // Synchronize with the view's filtered sources container. DebuggerView.FilteredSources.syncFileSearch(); // Hide all the groups with no visible children. view.widget.hideEmptyGroups(); // Ensure the currently selected item is visible. view.widget.ensureSelectionIsVisible({ withGroup: true }); // Remember the previously searched file to avoid redundant filtering. this._prevSearchedFile = aFile; }, /** * Performs a line search if necessary. * (Jump to lines in the currently visible source). * * @param number aLine * The source line number to jump to. */ _performLineSearch: function(aLine) { // Don't search for lines if the input hasn't changed. if (this._prevSearchedLine != aLine && aLine) { DebuggerView.editor.setCaretPosition(aLine - 1); } // Can't search for lines and tokens at the same time. if (this._prevSearchedToken && !aLine) { this._target.refresh(); } // Remember the previously searched line to avoid redundant filtering. this._prevSearchedLine = aLine; }, /** * Performs a token search if necessary. * (Search for tokens in the currently visible source). * * @param string aToken * The source token to find. */ _performTokenSearch: function(aToken) { // Don't search for tokens if the input hasn't changed. if (this._prevSearchedToken != aToken && aToken) { let editor = DebuggerView.editor; let offset = editor.find(aToken, { ignoreCase: true }); if (offset > -1) { editor.setSelection(offset, offset + aToken.length) } } // Can't search for tokens and lines at the same time. if (this._prevSearchedLine && !aToken) { this._target.refresh(); } // Remember the previously searched token to avoid redundant filtering. this._prevSearchedToken = aToken; }, /** * The click listener for the search container. */ _onClick: function() { this._searchboxHelpPanel.openPopup(this._searchbox); }, /** * The search listener for the search container. */ _onSearch: function() { this._searchboxHelpPanel.hidePopup(); let [operator, file, line, token] = this.searchboxInfo; // If this is a global search, schedule it for when the user stops typing, // or hide the corresponding pane otherwise. if (operator == SEARCH_GLOBAL_FLAG) { DebuggerView.GlobalSearch.scheduleSearch(token); this._prevSearchedToken = token; return; } // If this is a function search, schedule it for when the user stops typing, // or hide the corresponding panel otherwise. if (operator == SEARCH_FUNCTION_FLAG) { DebuggerView.FilteredFunctions.scheduleSearch(token); this._prevSearchedToken = token; return; } // If this is a variable search, defer the action to the corresponding // variables view instance. if (operator == SEARCH_VARIABLE_FLAG) { DebuggerView.Variables.scheduleSearch(token); this._prevSearchedToken = token; return; } DebuggerView.GlobalSearch.clearView(); DebuggerView.FilteredFunctions.clearView(); this._performFileSearch(file); this._performLineSearch(line); this._performTokenSearch(token); }, /** * The key press listener for the search container. */ _onKeyPress: function(e) { // This attribute is not implemented in Gecko at this time, see bug 680830. e.char = String.fromCharCode(e.charCode); let [operator, file, line, token] = this.searchboxInfo; let isGlobal = operator == SEARCH_GLOBAL_FLAG; let isFunction = operator == SEARCH_FUNCTION_FLAG; let isVariable = operator == SEARCH_VARIABLE_FLAG; let action = -1; if (file && !line && !token) { var isFileSearch = true; } if (line && !token) { var isLineSearch = true; } if (this._prevSearchedToken != token) { var isDifferentToken = true; } // Meta+G and Ctrl+N focus next matches. if ((e.char == "g" && e.metaKey) || e.char == "n" && e.ctrlKey) { action = 0; } // Meta+Shift+G and Ctrl+P focus previous matches. else if ((e.char == "G" && e.metaKey) || e.char == "p" && e.ctrlKey) { action = 1; } // Return, enter, down and up keys focus next or previous matches, while // the escape key switches focus from the search container. else switch (e.keyCode) { case e.DOM_VK_RETURN: case e.DOM_VK_ENTER: var isReturnKey = true; // fall through case e.DOM_VK_DOWN: action = 0; break; case e.DOM_VK_UP: action = 1; break; case e.DOM_VK_ESCAPE: action = 2; break; } if (action == 2) { DebuggerView.editor.focus(); return; } if (action == -1 || (!operator && !file && !line && !token)) { return; } e.preventDefault(); e.stopPropagation(); // Select the next or previous file search entry. if (isFileSearch) { if (isReturnKey) { DebuggerView.FilteredSources.clearView(); DebuggerView.editor.focus(); this.clearSearch(); } else { DebuggerView.FilteredSources[["selectNext", "selectPrev"][action]](); } this._prevSearchedFile = file; return; } // Perform a global search based on the specified operator. if (isGlobal) { if (isReturnKey && (isDifferentToken || DebuggerView.GlobalSearch.hidden)) { DebuggerView.GlobalSearch.performSearch(token); } else { DebuggerView.GlobalSearch[["selectNext", "selectPrev"][action]](); } this._prevSearchedToken = token; return; } // Perform a function search based on the specified operator. if (isFunction) { if (isReturnKey && (isDifferentToken || DebuggerView.FilteredFunctions.hidden)) { DebuggerView.FilteredFunctions.performSearch(token); } else if (!isReturnKey) { DebuggerView.FilteredFunctions[["selectNext", "selectPrev"][action]](); } else { DebuggerView.FilteredFunctions.clearView(); DebuggerView.editor.focus(); this.clearSearch(); } this._prevSearchedToken = token; return; } // Perform a variable search based on the specified operator. if (isVariable) { if (isReturnKey && isDifferentToken) { DebuggerView.Variables.performSearch(token); } else { DebuggerView.Variables.expandFirstSearchResults(); } this._prevSearchedToken = token; return; } // Increment or decrement the specified line. if (isLineSearch && !isReturnKey) { line += action == 0 ? 1 : -1; let lineCount = DebuggerView.editor.getLineCount(); let lineTarget = line < 1 ? 1 : line > lineCount ? lineCount : line; DebuggerView.editor.setCaretPosition(lineTarget - 1); this._searchbox.value = file + SEARCH_LINE_FLAG + lineTarget; this._prevSearchedLine = lineTarget; return; } let editor = DebuggerView.editor; let offset = editor[["findNext", "findPrevious"][action]](true); if (offset > -1) { editor.setSelection(offset, offset + token.length) } }, /** * The blur listener for the search container. */ _onBlur: function() { DebuggerView.GlobalSearch.clearView(); DebuggerView.FilteredSources.clearView(); DebuggerView.FilteredFunctions.clearView(); DebuggerView.Variables.performSearch(null); this._searchboxHelpPanel.hidePopup(); }, /** * Called when a filtering key sequence was pressed. * * @param string aOperator * The operator to use for filtering. */ _doSearch: function(aOperator = "") { this._searchbox.focus(); this._searchbox.value = ""; // Need to clear value beforehand. Bug 779738. this._searchbox.value = aOperator + DebuggerView.getEditorSelectionText(); }, /** * Called when the source location filter key sequence was pressed. */ _doFileSearch: function() { this._doSearch(); this._searchboxHelpPanel.openPopup(this._searchbox); }, /** * Called when the global search filter key sequence was pressed. */ _doGlobalSearch: function() { this._doSearch(SEARCH_GLOBAL_FLAG); this._searchboxHelpPanel.hidePopup(); }, /** * Called when the source function filter key sequence was pressed. */ _doFunctionSearch: function() { this._doSearch(SEARCH_FUNCTION_FLAG); this._searchboxHelpPanel.hidePopup(); }, /** * Called when the source token filter key sequence was pressed. */ _doTokenSearch: function() { this._doSearch(SEARCH_TOKEN_FLAG); this._searchboxHelpPanel.hidePopup(); }, /** * Called when the source line filter key sequence was pressed. */ _doLineSearch: function() { this._doSearch(SEARCH_LINE_FLAG); this._searchboxHelpPanel.hidePopup(); }, /** * Called when the variable search filter key sequence was pressed. */ _doVariableSearch: function() { DebuggerView.Variables.performSearch(""); this._doSearch(SEARCH_VARIABLE_FLAG); this._searchboxHelpPanel.hidePopup(); }, /** * Called when the variables focus key sequence was pressed. */ _doVariablesFocus: function() { DebuggerView.showInstrumentsPane(); DebuggerView.Variables.focusFirstVisibleItem(); }, _searchbox: null, _searchboxHelpPanel: null, _globalOperatorButton: null, _globalOperatorLabel: null, _functionOperatorButton: null, _functionOperatorLabel: null, _tokenOperatorButton: null, _tokenOperatorLabel: null, _lineOperatorButton: null, _lineOperatorLabel: null, _variableOperatorButton: null, _variableOperatorLabel: null, _fileSearchKey: "", _globalSearchKey: "", _filteredFunctionsKey: "", _tokenSearchKey: "", _lineSearchKey: "", _variableSearchKey: "", _target: null, _prevSearchedFile: "", _prevSearchedLine: 0, _prevSearchedToken: "" }; /** * Functions handling the filtered sources UI. */ function FilteredSourcesView() { dumpn("FilteredSourcesView was instantiated"); this._onClick = this._onClick.bind(this); this._onSelect = this._onSelect.bind(this); } FilteredSourcesView.prototype = Heritage.extend(ResultsPanelContainer.prototype, { /** * Initialization function, called when the debugger is started. */ initialize: function() { dumpn("Initializing the FilteredSourcesView"); this.anchor = document.getElementById("searchbox"); this.widget.addEventListener("select", this._onSelect, false); this.widget.addEventListener("click", this._onClick, false); }, /** * Destruction function, called when the debugger is closed. */ destroy: function() { dumpn("Destroying the FilteredSourcesView"); this.widget.removeEventListener("select", this._onSelect, false); this.widget.removeEventListener("click", this._onClick, false); this.anchor = null; }, /** * Updates the list of sources displayed in this container. */ syncFileSearch: function() { this.empty(); // If there's no currently searched file, or there are no matches found, // hide the popup and avoid creating the view again. if (!DebuggerView.Filtering.searchedFile || !DebuggerView.Sources.visibleItems.length) { this.hidden = true; return; } // Get the currently visible items in the sources container. let visibleItems = DebuggerView.Sources.visibleItems; let displayedItems = visibleItems.slice(0, RESULTS_PANEL_MAX_RESULTS); // Append a location item item to this container. for (let item of displayedItems) { let trimmedLabel = SourceUtils.trimUrlLength(item.label); let trimmedValue = SourceUtils.trimUrlLength(item.value, 0, "start"); let locationItem = this.push([trimmedLabel, trimmedValue], { relaxed: true, /* this container should allow dupes & degenerates */ attachment: { fullLabel: item.label, fullValue: item.value } }); } // Select the first entry in this container. this.selectedIndex = 0; // Only display the results panel if there's at least one entry available. this.hidden = this.itemCount == 0; }, /** * The click listener for this container. */ _onClick: function(e) { let locationItem = this.getItemForElement(e.target); if (locationItem) { this.selectedItem = locationItem; DebuggerView.Filtering.clearSearch(); } }, /** * The select listener for this container. * * @param object aItem * The item associated with the element to select. */ _onSelect: function({ detail: locationItem }) { if (locationItem) { DebuggerView.updateEditor(locationItem.attachment.fullValue, 0); } } }); /** * Functions handling the function search UI. */ function FilteredFunctionsView() { dumpn("FilteredFunctionsView was instantiated"); this._performFunctionSearch = this._performFunctionSearch.bind(this); this._onClick = this._onClick.bind(this); this._onSelect = this._onSelect.bind(this); } FilteredFunctionsView.prototype = Heritage.extend(ResultsPanelContainer.prototype, { /** * Initialization function, called when the debugger is started. */ initialize: function() { dumpn("Initializing the FilteredFunctionsView"); this.anchor = document.getElementById("searchbox"); this.widget.addEventListener("select", this._onSelect, false); this.widget.addEventListener("click", this._onClick, false); }, /** * Destruction function, called when the debugger is closed. */ destroy: function() { dumpn("Destroying the FilteredFunctionsView"); this.widget.removeEventListener("select", this._onSelect, false); this.widget.removeEventListener("click", this._onClick, false); this.anchor = null; }, /** * Allows searches to be scheduled and delayed to avoid redundant calls. */ delayedSearch: true, /** * Schedules searching for a function in all of the sources. * * @param string aQuery * The function to search for. */ scheduleSearch: function(aQuery) { if (!this.delayedSearch) { this.performSearch(aQuery); return; } let delay = Math.max(FUNCTION_SEARCH_ACTION_MAX_DELAY / aQuery.length, 0); window.clearTimeout(this._searchTimeout); this._searchFunction = this._startSearch.bind(this, aQuery); this._searchTimeout = window.setTimeout(this._searchFunction, delay); }, /** * Immediately searches for a function in all of the sources. * * @param string aQuery * The function to search for. */ performSearch: function(aQuery) { window.clearTimeout(this._searchTimeout); this._searchFunction = null; this._startSearch(aQuery); }, /** * Starts searching for a function in all of the sources. * * @param string aQuery * The function to search for. */ _startSearch: function(aQuery) { this._searchedToken = aQuery; DebuggerController.SourceScripts.fetchSources(DebuggerView.Sources.values, { onFinished: this._performFunctionSearch }); }, /** * Finds function matches in all the sources stored in the cache, and groups * them by location and line number. */ _performFunctionSearch: function() { // Get the currently searched token from the filtering input. // Continue parsing even if the searched token is an empty string, to // cache the syntax tree nodes generated by the reflection API. let token = this._searchedToken; // Make sure the currently displayed source is parsed first. Once the // maximum allowed number of resutls are found, parsing will be halted. let sourcesCache = DebuggerController.SourceScripts.getCache(); let currentUrl = DebuggerView.Sources.selectedValue; sourcesCache.sort(function([sourceUrl]) sourceUrl == currentUrl ? -1 : 1); // If not searching for a specific function, only parse the displayed source. if (!token) { sourcesCache.splice(1); } // Prepare the results array, containing search details for each source. let searchResults = []; for (let [location, contents] of sourcesCache) { let parserMethods = DebuggerController.Parser.get(location, contents); let sourceResults = parserMethods.getNamedFunctionDefinitions(token); for (let scriptResult of sourceResults) { for (let parseResult of scriptResult.parseResults) { searchResults.push({ sourceUrl: scriptResult.sourceUrl, scriptOffset: scriptResult.scriptOffset, functionName: parseResult.functionName, functionLocation: parseResult.functionLocation, inferredName: parseResult.inferredName, inferredChain: parseResult.inferredChain, inferredLocation: parseResult.inferredLocation }); // Once the maximum allowed number of results is reached, proceed // with building the UI immediately. if (searchResults.length >= RESULTS_PANEL_MAX_RESULTS) { this._syncFunctionSearch(searchResults); return; } } } } // Couldn't reach the maximum allowed number of results, but that's ok, // continue building the UI. this._syncFunctionSearch(searchResults); }, /** * Updates the list of functions displayed in this container. * * @param array aSearchResults * The results array, containing search details for each source. */ _syncFunctionSearch: function(aSearchResults) { this.empty(); // Show the popup even if the search token is an empty string. If there are // no matches found, hide the popup and avoid creating the view again. if (!aSearchResults.length) { this.hidden = true; return; } for (let item of aSearchResults) { // Some function expressions don't necessarily have a name, but the // parser provides us with an inferred name from an enclosing // VariableDeclarator, AssignmentExpression, ObjectExpression node. if (item.functionName && item.inferredName && item.functionName != item.inferredName) { let s = " " + L10N.getStr("functionSearchSeparatorLabel") + " "; item.displayedName = item.inferredName + s + item.functionName; } // The function doesn't have an explicit name, but it could be inferred. else if (item.inferredName) { item.displayedName = item.inferredName; } // The function only has an explicit name. else { item.displayedName = item.functionName; } // Some function expressions have unexpected bounds, since they may not // necessarily have an associated name defining them. if (item.inferredLocation) { item.actualLocation = item.inferredLocation; } else { item.actualLocation = item.functionLocation; } // Append a function item to this container. let trimmedLabel = SourceUtils.trimUrlLength(item.displayedName + "()"); let trimmedValue = SourceUtils.trimUrlLength(item.sourceUrl, 0, "start"); let description = (item.inferredChain || []).join("."); let functionItem = this.push([trimmedLabel, trimmedValue, description], { index: -1, /* specifies on which position should the item be appended */ relaxed: true, /* this container should allow dupes & degenerates */ attachment: item }); } // Select the first entry in this container. this.selectedIndex = 0; // Only display the results panel if there's at least one entry available. this.hidden = this.itemCount == 0; }, /** * The click listener for this container. */ _onClick: function(e) { let functionItem = this.getItemForElement(e.target); if (functionItem) { this.selectedItem = functionItem; DebuggerView.Filtering.clearSearch(); } }, /** * The select listener for this container. */ _onSelect: function({ detail: functionItem }) { if (functionItem) { let sourceUrl = functionItem.attachment.sourceUrl; let scriptOffset = functionItem.attachment.scriptOffset; let actualLocation = functionItem.attachment.actualLocation; DebuggerView.updateEditor(sourceUrl, actualLocation.start.line, { charOffset: scriptOffset, columnOffset: actualLocation.start.column, noDebug: true }); } }, _searchTimeout: null, _searchFunction: null, _searchedToken: "" }); /** * Preliminary setup for the DebuggerView object. */ DebuggerView.Toolbar = new ToolbarView(); DebuggerView.Options = new OptionsView(); DebuggerView.Filtering = new FilterView(); DebuggerView.FilteredSources = new FilteredSourcesView(); DebuggerView.FilteredFunctions = new FilteredFunctionsView(); DebuggerView.ChromeGlobals = new ChromeGlobalsView(); DebuggerView.StackFrames = new StackFramesView();