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
45 lines
1.3 KiB
JavaScript
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([]);
|
|
}
|
|
}
|