gecko/toolkit/devtools/server/child.js

121 lines
3.9 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";
try {
let chromeGlobal = this;
// Encapsulate in its own scope to allows loading this frame script
// more than once.
(function () {
let Cu = Components.utils;
let { devtools } = Cu.import("resource://gre/modules/devtools/Loader.jsm", {});
const DevToolsUtils = devtools.require("devtools/toolkit/DevToolsUtils.js");
const { dumpn } = DevToolsUtils;
const { DebuggerServer, ActorPool } = Cu.import("resource://gre/modules/devtools/dbg-server.jsm", {});
if (!DebuggerServer.childID) {
DebuggerServer.childID = 1;
}
if (!DebuggerServer.initialized) {
DebuggerServer.init();
// message manager helpers provided for actor module parent/child message exchange
DebuggerServer.parentMessageManager = {
sendSyncMessage: sendSyncMessage,
addMessageListener: addMessageListener
};
}
// In case of apps being loaded in parent process, DebuggerServer is already
// initialized, but child specific actors are not registered.
// Otherwise, for apps in child process, we need to load actors the first
// time we load child.js
DebuggerServer.addChildActors();
let connections = new Map();
let onConnect = DevToolsUtils.makeInfallible(function (msg) {
removeMessageListener("debug:connect", onConnect);
let mm = msg.target;
let prefix = msg.data.prefix;
let id = DebuggerServer.childID++;
let conn = DebuggerServer.connectToParent(prefix, mm);
connections.set(id, conn);
let actor = new DebuggerServer.ContentActor(conn, chromeGlobal);
let actorPool = new ActorPool(conn);
actorPool.addActor(actor);
conn.addActorPool(actorPool);
sendAsyncMessage("debug:actor", {actor: actor.form(), childID: id});
});
addMessageListener("debug:connect", onConnect);
// Allows executing module setup helper from the parent process.
// See also: DebuggerServer.setupInChild()
let onSetupInChild = DevToolsUtils.makeInfallible(msg => {
let { module, setupChild, args } = msg.data;
let m, fn;
try {
m = devtools.require(module);
if (!setupChild in m) {
dumpn("ERROR: module '" + module + "' does not export '" +
setupChild + "'");
return false;
}
m[setupChild].apply(m, args);
return true;
} catch(e) {
let error_msg = "exception during actor module setup running in the child process: ";
DevToolsUtils.reportException(error_msg + e);
dumpn("ERROR: " + error_msg + " \n\t module: '" + module +
"' \n\t setupChild: '" + setupChild + "'\n" +
DevToolsUtils.safeErrorString(e));
return false;
}
});
addMessageListener("debug:setup-in-child", onSetupInChild);
let onDisconnect = DevToolsUtils.makeInfallible(function (msg) {
removeMessageListener("debug:disconnect", onDisconnect);
// Call DebuggerServerConnection.close to destroy all child actors
// (It should end up calling DebuggerServerConnection.onClosed
// that would actually cleanup all actor pools)
let childID = msg.data.childID;
let conn = connections.get(childID);
if (conn) {
conn.close();
connections.delete(childID);
}
});
addMessageListener("debug:disconnect", onDisconnect);
let onInspect = DevToolsUtils.makeInfallible(function(msg) {
// Store the node to be inspected in a global variable
// (gInspectingNode). Later we'll fetch this variable again using
// the findInspectingNode request over the remote debugging
// protocol.
let inspector = devtools.require("devtools/server/actors/inspector");
inspector.setInspectingNode(msg.objects.node);
});
addMessageListener("debug:inspect", onInspect);
})();
} catch(e) {
dump("Exception in app child process: " + e + "\n");
}