Files
tubestation/toolkit/components/backgroundtasks/dbg-actors.js
Nick Alexander 5e08f60944 Bug 1686344 - Support --backgroundtask --jsdebugger (and --wait-for-jsdebugger). r=mossop,jdescottes
Background task mode is roughly equivalent to `xpcshell`, but inside
the regular browser startup flow.  There is no browser window (no
`Window` at all) and there should be no content processes.  It's
sufficient to treat it like `xpcshell`, with its own stripped-down
actor and a few tweaks to the integration points.

The structural changes in this commit keep `--backgroundtask` mode
slim in the regular case when the Devtools are *not* requested.  This
is reflected in the small changes needed to the
`browser_xpcom_graph_wait.js` test: loading the Devtools
unconditionally causes a huge amount of code to be loaded.  In order
to load the Devtools framework conditionally, we check for
Devtools-specific command line flags and delegate to Devtools when
appropriate.  In order to check the command line flags, we turn the
`BackgroundTasksManager` into an XPCOM service, which allows it to be
instantiated by XPCOM in order to handle the command line.

One final note: this leaves two XPCOM components, "backgroundtasks"
and "backgroundtasksmanager".  Why not combine them?  This is
technically possible but not attractive: we really do want a natural
place for native/C++ code ("backgroundtasks") and JavaScript code
("backgroundtasksmanager").

Differential Revision: https://phabricator.services.mozilla.com/D129771
2022-03-03 03:38:39 +00:00

45 lines
1.3 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/. */
/* globals require, exports */
"use strict";
const { DevToolsServer } = require("devtools/server/devtools-server");
const { RootActor } = require("devtools/server/actors/root");
const { BrowserTabList } = require("devtools/server/actors/webbrowser");
const { ProcessActorList } = require("devtools/server/actors/process");
const Services = require("Services");
const {
ActorRegistry,
} = require("devtools/server/actors/utils/actor-registry");
/**
* background-task specific actors.
*
*/
/**
* Construct a root actor appropriate for use in a server running a background task.
*/
function createRootActor(connection) {
let parameters = {
tabList: new BackgroundTaskTabList(connection),
processList: new ProcessActorList(),
globalActorFactories: ActorRegistry.globalActorFactories,
onShutdown() {},
};
return new RootActor(connection, parameters);
}
exports.createRootActor = createRootActor;
/**
* A "stub" TabList implementation that provides no tabs.
*/
class BackgroundTaskTabList extends BrowserTabList {
getList() {
return Promise.resolve([]);
}
}