启动 Firefox、使用特权 nsI* API 驱动第 3 方网站的最简单方法

启动 Firefox 最简单的方法是什么，加载第 3 方网站（我是授权的“自动化”），并针对该站点运行一些“特权”API？ （例如：nsIProgressListener、nsIWindowMediator 等）。

我尝试了两种方法：

1. 使用 XULrunner 创建选项卡式浏览器，“管道”第 3 方站点打开新窗口、遵循 302 重定向等所需的所有适当 API。这样做会产生大量代码，并且需要（据我所知）用户安装应用程序，或使用 -app 运行 Firefox。它也极其脆弱。 :-/

2. 启动 Firefox，传递第 3 方站点的 URL，MozRepl 已在侦听。然后启动后不久，从“启动”脚本远程登录到 MozRepl，使用 mozIJSSubScriptLoader::loadSubScript 加载我的代码，然后在第 3 方站点的上下文中从 MozRepl 执行我的代码 --这就是我目前正在做的方式.

使用第一种方法，我（显然）遇到了很多安全问题需要解决，而且看起来我编写的浏览器“管道”代码比自动化代码多了 10 倍。

使用第二种方法，我看到很多“计时问题”，即：

• MozRepl 以某种方式阻止第 3 方站点加载（或执行我提供的特权代码）？？？，或者
• 第 3 方网站加载，但 MozRepl 执行的代码看不到它加载，或者
• 第 3 方网站加载，并且 MozRepl 尚未准备好接受请求（尽管页面中运行其他 JavaScript，并且端口 4242 被 Firefox 进程绑定），
• etc.

我想也许做这样的事情：

以某种方式修改 MozRepl 源代码，以便在启动时从文件系统中的可预测位置加载特权 JavaScript（或与 Firefox 命令行参数交互），并在第 3 方网站的上下文中执行它。

...或者甚至编写另一个更专注于该任务的类似附加组件。

还有更简单的想法吗？

经过大量的反复试验，回答了我自己的问题（如下）。

我发现最简单的方法是编写一个专门构建的 Firefox 扩展！

Step 1.我不想做一堆不必要的 XUL/addon 相关的事情； “引导”（或无需重新启动）扩展只需要一个install.rdf文件来识别插件，以及bootstrap.js文件来实现引导接口。

• 引导扩展：https://developer.mozilla.org/en-US/docs/Extensions/Bootstrapped_extensions https://developer.mozilla.org/en-US/docs/Extensions/Bootstrapped_extensions

• 好例子：http://blog.fpmurphy.com/2011/02/firefox-4-restartless-add-ons.html http://blog.fpmurphy.com/2011/02/firefox-4-restartless-add-ons.html

bootstrap接口的实现非常简单：

const path = '/PATH/TO/EXTERNAL/CODE.js';
const Cc = Components.classes;
const Ci = Components.interfaces;
const Cu = Components.utils;
var loaderSvc = Cc["@mozilla.org/moz/jssubscript-loader;1"];
                    .getService(Ci.mozIJSSubScriptLoader);

function install() {}
function uninstall() {}
function shutdown(data, reason) {}
function startup(data, reason) { loaderSvc.loadSubScript("file://"+path); }

您可以通过输入来编译扩展install.rdf and bootstrap.js进入新 zip 文件的顶层，并将 zip 文件扩展名重命名为.xpi.

Step 2.为了拥有可重复的生产和测试环境，我发现最简单的方法是使用专用于自动化任务的配置文件启动 Firefox：

• 启动 Firefox 配置文件管理器：firefox -ProfileManager
• 创建一个新的配置文件，指定位置以便于重复使用（我将我的配置文件称为testing-profile），然后退出配置文件管理器。
• 从中删除新的配置文件profiles.ini在您用户的 mozilla 配置中（这样就不会干扰正常浏览）。
• 使用该配置文件启动 Firefox：firefox -profile /path/to/testing-profile
• 从文件系统（而不是 addons.mozilla.org）安装扩展。
• 执行准备配置文件所需的任何其他操作。 （例如：我需要添加第 3 方证书并允许相关域的弹出窗口。）
• 留个单about:blank打开选项卡，然后退出 Firefox。
• 快照配置文件：tar cvf testing-profile-snapshot.tar /path/to/testing-profile

从那时起，每次运行自动化时，我都会解压testing-profile-snapshot.tar超过现有的testing-profile文件夹并运行firefox -profile /path/to/testing-profile about:blank使用“原始”配置文件。

Step 3.所以现在当我启动 Firefox 时testing-profile它将“包含”外部代码/PATH/TO/EXTERNAL/CODE.js在每次启动时。

NOTE:我发现我必须移动/PATH/TO/EXTERNAL/步骤期间别处的文件夹2如上所述，因为外部 JavaScript 代码将被缓存（!!!- 在开发过程中不需要）在配置文件内（即：在下次启动时不会看到对外部代码的更改）。

外部代码具有特权，可以使用任何 Mozilla 平台 API。然而，存在一个时机的问题。包含外部代码（并因此执行）的时刻是没有 Chrome 窗口对象（因此没有DOMWindow对象）仍然存在。

所以我们需要等待，直到有一个有用的DOMWindow object:

// useful services.
Cu.import("resource://gre/modules/Services.jsm");    
var loader = Cc["@mozilla.org/moz/jssubscript-loader;1"]
                .getService(Ci.mozIJSSubScriptLoader);

var wmSvc = Cc["@mozilla.org/appshell/window-mediator;1"]
                .getService(Ci.nsIWindowMediator);

var logSvc = Cc["@mozilla.org/consoleservice;1"]
                .getService(Ci.nsIConsoleService);

// "user" code entry point.
function user_code() {   
   // your code here!
   // window, gBrowser, etc work as per MozRepl!
}

// get the gBrowser, first (about:blank) domWindow, 
// and set up common globals.
var done_startup = 0;
var windowListener;
function do_startup(win) {

    if (done_startup) return;
    done_startup = 1;
    wm.removeListener(windowListener);

    var browserEnum = wm.getEnumerator("navigator:browser");
    var browserWin = browserEnum.getNext();
    var tabbrowser = browserWin.gBrowser;
    var currentBrowser = tabbrowser.getBrowserAtIndex(0);
    var domWindow = currentBrowser.contentWindow;
    window = domWindow.QueryInterface(Ci.nsIInterfaceRequestor)
                 .getInterface(Ci.nsIWebNavigation)
                 .QueryInterface(Ci.nsIDocShellTreeItem)
                 .rootTreeItem.QueryInterface(Ci.nsIInterfaceRequestor)
                 .getInterface(Ci.nsIDOMWindow);
    gBrowser = window.gBrowser;

    setTimeout = window.setTimeout;
    setInterval = window.setInterval;
    alert = function(message) { 
        Services.prompt.alert(null, "alert", message); 
    };
    console = { 
        log: function(message) { 
            logSvc.logStringMessage(message); 
        } 
    };

    // the first domWindow will finish loading a little later than gBrowser...
    gBrowser.addEventListener('load', function() {
        gBrowser.removeEventListener('load', arguments.callee, true);
        user_code();
    }, true);
}

// window listener implementation
windowListener = {
    onWindowTitleChange: function(aWindow, aTitle) {},
    onCloseWindow:       function(aWindow) {},
    onOpenWindow:        function(aWindow) {
        var win = aWindow.QueryInterface(Ci.nsIInterfaceRequestor)
                     .getInterface(Ci.nsIDOMWindowInternal || Ci.nsIDOMWindow);
        win.addEventListener("load", function(aEvent) {
            win.removeEventListener("load", arguments.callee, false);
            if (aEvent.originalTarget.nodeName != "#document") return;
            do_startup();
        }
};

// CODE ENTRY POINT!
wm.addListener(windowListener);

Step 4.所有这些代码都在“全局”范围内执行。如果您稍后需要加载其他 JavaScript 文件（例如：jQuery），请调用loadSubscript明确地在null（全球！）范围

function some_user_code() {
    loader.loadSubScript.call(null,"file:///PATH/TO/SOME/CODE.js");
    loader.loadSubScript.call(null,"http://HOST/PATH/TO/jquery.js");
    $ = jQuery = window.$;
}

现在我们可以使用jQuery on any DOMWindow通过传递<DOMWindow>.document作为选择器调用的第二个参数！