fune/devtools/shared/flags.js
Alexandre Poirot 7f9229d43d Bug 1789201 - [devtools] Expose Services as a global to all DevTools modules. r=perftest-reviewers,nchevobbe,julienw,AlexandruIonescu
This will help transition to ES Modules as this symbol is exposed to them.

$ sed -ie "/require(.Services.)/d" $(git grep -l 'require("Services")' devtools/)
$ sed -ie "/loader.lazyRequireGetter(this, .Services./d" $(git grep -l 'loader.lazyRequireGetter(this, "Services"' devtools/)
+ the edition of builtin-modules.js + eslintrc.js
+ manual eslint fixes
+ removal of devtools-services in the debugger, except for jest tests

Differential Revision: https://phabricator.services.mozilla.com/D156401
2022-09-09 07:22:51 +00:00

69 lines
2.5 KiB
JavaScript

/* 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 controls various global flags that can be toggled on and off.
* These flags are generally used to change the behavior of the code during
* testing. They are tracked by preferences so that they are propagated
* between the parent and content processes. The flags are exposed via a module
* as a conveniene and to stop from littering preference names throughout the
* code ase.
*
* Each of the flags is documented where it is defined.
*/
/**
* We cannot make a normal property writeable on `exports` because
* the module system freezes it. This function observes a preference
* and provides the latest value through a getter.
*/
function makePrefTrackedFlag(exports, name, pref) {
let flag;
// We don't have access to pref in worker, so disable all logs by default
if (isWorker) {
flag = false;
} else {
flag = Services.prefs.getBoolPref(pref, false);
const prefObserver = () => {
flag = Services.prefs.getBoolPref(pref, false);
};
Services.prefs.addObserver(pref, prefObserver);
// Also listen for Loader unload to unregister the pref observer and prevent leaking
const unloadObserver = function(subject) {
if (subject.wrappedJSObject == require("@loader/unload")) {
Services.prefs.removeObserver(pref, prefObserver);
Services.obs.removeObserver(unloadObserver, "devtools:loader:destroy");
}
};
Services.obs.addObserver(unloadObserver, "devtools:loader:destroy");
}
Object.defineProperty(exports, name, {
get() {
return flag;
},
});
}
/**
* Setting the "devtools.debugger.log" preference to true will enable logging of
* the RDP calls to the devtools server.
*/
makePrefTrackedFlag(exports, "wantLogging", "devtools.debugger.log");
/**
* Setting the "devtools.debugger.log.verbose" preference to true will enable a
* more verbose logging of the the RDP. The "devtools.debugger.log" preference
* must be set to true as well for this to have any effect.
*/
makePrefTrackedFlag(exports, "wantVerbose", "devtools.debugger.log.verbose");
/**
* Setting the "devtools.testing" preference to true will toggle on certain
* behaviors that can differ from the production version of the code. These
* behaviors typically enable easier testing or enhanced debugging features.
*/
makePrefTrackedFlag(exports, "testing", "devtools.testing");