2

我开始构建一个无需重启的 Firefox 插件,但在设置 bootstrap.js 时遇到了问题。每个人似乎都同意 bootstrap.js 的核心几乎是样板代码,大致如下:

const Cc = Components.classes;
const Ci = Components.interfaces;

function startup() {
  let wm = Cc["@mozilla.org/appshell/window-mediator;1"].getService(Ci.nsIWindowMediator);
  let windows = wm.getEnumerator("navigator:browser");
  while (windows.hasMoreElements()) {
    let domWindow = windows.getNext().QueryInterface(Ci.nsIDOMWindow); 
    // then can control what happens with domWindow.document
  } 
}
function shutdown() {}
function install() {}
function uninstall() {}

此代码有效,我可以控制现有窗口中的内容。例如,domWindow.alert("text")在当前打开的每个窗口上成功创建一个标准警报,显示“文本”。

但是,我找不到任何可以让我在新窗口中执行操作的代码;即脚本运行后创建的那些。处理新窗口的创建并获得对它们的控制的正确方法是什么,以至于我可以在创建新窗口时获得另一个“文本”警报?

编辑:使用 nsWindowMediator 类和来自 MDN 的代码示例,我现在有了这个:

var windowListener = {
onOpenWindow: function (aWindow) {
  try {
    let domWindow = aWindow.QueryInterface(Ci.nsIInterfaceRequestor).getInterface(Ci.nsIDOMWindowInternal || Ci.nsIDOMWindow);
    domWindow.addEventListener("load", function () {
      domWindow.removeEventListener("load", arguments.callee, false);
      //window has now loaded now do stuff to it
      domWindow.alert("text");
    }, false);
  } catch (err) {
    Services.prompt.alert(null, "Error", err);
  }
},
onCloseWindow: function (aWindow) {},
onWindowTitleChange: function (aWindow, aTitle) {}
};

function startup(aData, aReason) {
  // Load into any existing windows
  try {
    let wm = Cc["@mozilla.org/appshell/window-mediator;1"].getService(Ci.nsIWindowMediator);
    let windows = wm.getEnumerator("navigator:browser");
    while (windows.hasMoreElements()) {
      let domWindow = windows.getNext().QueryInterface(Ci.nsIDOMWindow);
      loadIntoWindow(domWindow);
    }
  } catch (err) {
    Services.prompt.alert(null, "Error", err);
  }

  Services.wm.addListener(windowListener);
}

但是,onOpenWindow 调用仍然没有输出——“文本”警报没有出现,catch 块中的错误警报也没有出现。我可以确认实际上正在输入 onOpenWindow;如果我Services.prompt.alert()在 onOpenWindow 的开头加上 a,我会在创建新窗口时收到警报。不幸的是,我收到了无限循环的警报,我不知道为什么。

4

2 回答 2

2

但是,我找不到任何可以让我在新窗口中执行操作的代码;即脚本运行后创建的那些。处理新窗口的创建并获得对它们的控制的正确方法是什么,以至于我可以在创建新窗口时获得另一个“文本”警报?

在每个窗口打开时对其进行操作的正确方法是使用addListener()from nsIWindowMediator。下面的示例代码就是这样做的。nsIWindowMediator 包含在Services.jsm中,可通过Services.wm.addListener(WindowListener). 为了使用窗口侦听器,您必须向它传递一个nsIWindowMediatorListener ( ref2 ) 对象。nsIWindowMediatorListener 包含三个键:onOpenWindowonCloseWindowonWindowTitleChange。每个都应该被定义为一个函数,当适当的事件发生时将被调用。

MDN 文档“第 9 步:bootstrap.js ”中的How to convert an overlay extension to restartless包含一个基本bootstrap.js示例,它将为每个当前打开的浏览器窗口和任何打开的浏览器窗口运行函数中的代码未来。我在几个不同的附加组件中使用了由此修改的代码。该示例与您已经使用的代码基本相似。示例为(稍作修改):loadIntoWindow(window)

const Ci = Components.interfaces;

Components.utils.import("resource://gre/modules/Services.jsm");

function startup(data,reason) {
    // Load this add-ons module(s):
    Components.utils.import("chrome://myAddon/content/myModule.jsm");
    // Do whatever initial startup stuff is needed for this add-on.
    //   Code is in module just loaded.
    myModule.startup();  

    // Make changes to the Firefox UI to hook in this add-on
    forEachOpenWindow(loadIntoWindow);
    // Listen for any windows that open in the future
    Services.wm.addListener(WindowListener);
}

function shutdown(data,reason) {
    if (reason == APP_SHUTDOWN)
        return;

    // Unload the UI from each window
    forEachOpenWindow(unloadFromWindow);
    // Stop listening for new windows to open.
    Services.wm.removeListener(WindowListener);

    // Do whatever shutdown stuff you need to do on add-on disable
    myModule.shutdown();  

    // Unload the module(s) loaded specific to this extension.
    // Use the same URL for your module(s) as when loaded:
    Components.utils.unload("chrome://myAddon/content/myModule.jsm"); 

    // HACK WARNING: The Addon Manager does not properly clear all add-on related caches
    //               on update. In order to fully update images and locales, their
    //               caches need clearing here.
    Services.obs.notifyObservers(null, "chrome-flush-caches", null);
}

function install(data,reason) { }

function uninstall(data,reason) { }

function loadIntoWindow(window) {
    /* call/move your UI construction function here */
}

function unloadFromWindow(window) {
    /* call/move your UI tear down function here */
}

function forEachOpenWindow(todo) {
    // Apply a function to all open browser windows
    var windows = Services.wm.getEnumerator("navigator:browser");
    while (windows.hasMoreElements())
        todo(windows.getNext().QueryInterface(Ci.nsIDOMWindow));
}

var WindowListener = {
    onOpenWindow: function(xulWindow) {
        var window = xulWindow.QueryInterface(Ci.nsIInterfaceRequestor)
                              .getInterface(Ci.nsIDOMWindow);
        function onWindowLoad() {
            window.removeEventListener("load",onWindowLoad);
            // Only add UI changes if this is a browser window
            if (window.document.documentElement.getAttribute("windowtype") 
                                                                == "navigator:browser")
                loadIntoWindow(window);
        }
        window.addEventListener("load",onWindowLoad);
    },
    onCloseWindow: function(xulWindow) { },
    onWindowTitleChange: function(xulWindow, newTitle) { }
};

虽然您可能希望在bootstrap.js代码中执行更多操作,但上面的代码组织得相当好,并将所有代码加载到 Firefox UI 中loadIntoWindow(window)并在 .js 中卸载 UI unloadFromWindow(window)。但是,应该注意的是,某些 UI 元素应该只添加/删除一次(例如 australis 小部件,如按钮),而其他元素(例如直接更改 Firefox DOM)必须在每个窗口中添加一次。

不幸的是,我收到了无限循环的警报,我不知道为什么。

此示例与您当前使用的示例之间的显着差异之一是对已打开窗口类型的测试。这样做是为了让我们只对新打开的窗口进行操作,这些窗口是浏览器窗口,而不是所有新打开的窗口:

if (window.document.documentElement.getAttribute("windowtype") == "navigator:browser")
    loadIntoWindow(window);

您描述的出现无限循环alert()弹出窗口的问题是由于未检查以确保您仅在浏览器窗口上操作而引起的。弹出窗口是alert()一个窗口。因此,您正在调用您打开alert()的每个alert()窗口,当然,它只会打开另一个alert()您调用的窗口alert()。这是你的无限循环。

附加参考:
1.在 chrome 代码中使用 windows

于 2015-03-21T17:13:02.977 回答
2

但是,我找不到任何可以让我在新窗口中执行操作的代码

使用 XPCOM 对象时,您通常希望研究它们的接口,这些接口通常可以在 MDN 上找到。在这种情况下,您的起点将是nsIWindowMediator,因为这是您在第 5 行中使用的服务。

正如你所看到的,它有一个addListener函数,它接受一个参数来实现nsIWindowMediatorListener. 页面上有一个代码示例。

但是让我们暂时假设没有代码示例。您可以在 MDN 上搜索该接口,但未列出。下一步是在 MXR 中搜索 .idlidl =接口描述语言

一旦你获得了接口契约,你可以或多或少地用 javascript 来实现它,至少对于听众来说是这样。实现您自己的 xpcom 服务会稍微复杂一些

搜索插件 sdk通常也可以提供一些提示。在这种情况下,他们似乎没有使用.addListener,但该文件暗示了另一个有趣的服务,您可以在 MDN 上找到该服务:nsIWindowWatcher

基本上,如果您正在编写无需重启的插件,您就是在翻找 firefox 的内脏,并且必须做一些侦探工作来找到您需要的确切组件。如果您想要更方便的东西,我会推荐插件 sdk,它提供了一组更有条理但也更受限制的常用 API

于 2015-03-21T02:50:44.713 回答