tor-browser

menus.js (5527B)

---

/* 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";

/**
* This module defines the sorted list of menuitems inserted into the
* "Browser Tools" menu.
* It also defines the key shortcuts that relates to them.
*
* Various fields are necessary for historical compatiblity with XUL/addons:
* - id:
*   used as <xul:menuitem> id attribute
* - l10nKey:
*   prefix used to locale localization strings from menus.properties
* - oncommand:
*   function called when the menu item or key shortcut are fired
* - keyId:
*   Identifier used in devtools/client/devtools-startup.js
*   Helps figuring out the DOM id for the related <xul:key>
*   in order to have the key text displayed in menus.
* - checkbox:
*   If true, the menuitem is prefixed by a checkbox and runtime code can
*   toggle it.
*/

const lazy = {};
ChromeUtils.defineESModuleGetters(lazy, {
 BrowserToolboxLauncher:
   "resource://devtools/client/framework/browser-toolbox/Launcher.sys.mjs",
});

loader.lazyRequireGetter(this, "flags", "resource://devtools/shared/flags.js");

loader.lazyRequireGetter(
 this,
 "gDevToolsBrowser",
 "resource://devtools/client/framework/devtools-browser.js",
 true
);
loader.lazyRequireGetter(
 this,
 "ResponsiveUIManager",
 "resource://devtools/client/responsive/manager.js"
);
loader.lazyRequireGetter(
 this,
 "openDocLink",
 "resource://devtools/client/shared/link.js",
 true
);
loader.lazyRequireGetter(
 this,
 "CommandsFactory",
 "resource://devtools/shared/commands/commands-factory.js",
 true
);

loader.lazyRequireGetter(
 this,
 "PICKER_TYPES",
 "resource://devtools/shared/picker-constants.js"
);

exports.menuitems = [
 {
   id: "menu_devToolbox",
   l10nKey: "webDeveloperToolsMenu",
   oncommand(event) {
     try {
       const window = event.target.ownerDocument.defaultView;
       gDevToolsBrowser.toggleToolboxCommand(
         window.gBrowser,
         ChromeUtils.now()
       );
     } catch (e) {
       console.error(`Exception while opening the toolbox: ${e}\n${e.stack}`);
     }
   },
   keyId: "toggleToolbox",
   checkbox: true,
 },
 {
   id: "menu_devtools_remotedebugging",
   l10nKey: "devtoolsRemoteDebugging",
   oncommand(event) {
     const window = event.target.ownerDocument.defaultView;
     gDevToolsBrowser.openAboutDebugging(window.gBrowser);
   },
 },
 {
   id: "menu_browserToolbox",
   l10nKey: "browserToolboxMenu",
   oncommand() {
     lazy.BrowserToolboxLauncher.init();
   },
   keyId: "browserToolbox",
 },
 {
   id: "menu_browserConsole",
   l10nKey: "browserConsoleCmd",
   oncommand() {
     const {
       BrowserConsoleManager,
     } = require("resource://devtools/client/webconsole/browser-console-manager.js");
     BrowserConsoleManager.openBrowserConsoleOrFocus();
   },
   keyId: "browserConsole",
 },
 {
   id: "menu_responsiveUI",
   l10nKey: "responsiveDesignMode",
   oncommand(event) {
     const window = event.target.ownerDocument.defaultView;
     ResponsiveUIManager.toggle(window, window.gBrowser.selectedTab, {
       trigger: "menu",
     });
   },
   keyId: "responsiveDesignMode",
   checkbox: true,
 },
 {
   id: "menu_eyedropper",
   l10nKey: "eyedropper",
   async oncommand(event) {
     const window = event.target.ownerDocument.defaultView;

     // The eyedropper might be used without a toolbox, so it should use a
     // dedicated commands instance.
     // See Bug 1701004.
     const commands = await CommandsFactory.forTab(
       window.gBrowser.selectedTab
     );
     await commands.targetCommand.startListening();

     const target = commands.targetCommand.targetFront;
     const inspectorFront = await target.getFront("inspector");

     // If RDM is active, disable touch simulation events if they're enabled.
     // Similarly, enable them when the color picker is done picking.
     if (
       ResponsiveUIManager.isActiveForTab(commands.descriptorFront.localTab)
     ) {
       const ui = ResponsiveUIManager.getResponsiveUIForTab(
         commands.descriptorFront.localTab
       );
       await ui.setElementPickerState(true, PICKER_TYPES.EYEDROPPER);

       inspectorFront.once("color-picked", async () => {
         await ui.setElementPickerState(false, PICKER_TYPES.EYEDROPPER);
       });

       inspectorFront.once("color-pick-canceled", async () => {
         await ui.setElementPickerState(false, PICKER_TYPES.EYEDROPPER);
       });
     }

     // Destroy the dedicated commands instance when the color picking is
     // finished.
     inspectorFront.once("color-picked", () => commands.destroy());
     inspectorFront.once("color-pick-canceled", () => commands.destroy());

     inspectorFront.pickColorFromPage({ copyOnSelect: true, fromMenu: true });

     if (flags.testing) {
       // Used in devtools/client/inspector/test/browser_inspector_eyedropper_ruleview.js
       Services.obs.notifyObservers(
         { wrappedJSObject: target },
         "color-picker-command-handled"
       );
     }
   },
   checkbox: true,
 },
 {
   id: "extensionsForDevelopers",
   l10nKey: "extensionsForDevelopersCmd",
   appMenuL10nId: "appmenu-developer-tools-extensions",
   oncommand() {
     openDocLink(
       "https://addons.mozilla.org/firefox/collections/mozilla/webdeveloper/"
     );
   },
 },
];