如何在Thunderbird扩展的其他模块中使用原生jQuery库

我正在尝试把jQuery库整合到自定义的jquery.jsm模块里，让其他模块能通过引用这个模块来使用jQuery。但原生jQuery依赖浏览器的window对象，而在XPCOM模块环境中并没有这个全局对象，所以必须手动构建所需的window上下文。

目前我已经写了jquery.jsm的部分代码：

const EXPORTED_SYMBOLS = ['jQuery'];
var xjQuery = null;
var window = null;
var location = null;
var wm = Components.classes["@mozilla.org/appshell/window-mediator;1"].getService(Components.interfaces.nsIWindowMediator);
var enumerator = wm.getEnumerator(null);
// 后续的窗口遍历判断逻辑...

针对这个需求，我整理了一套完整的实现方案：

核心思路 #

通过Firefox的Window Mediator获取当前活跃的浏览器窗口，将其作为jQuery所需的window上下文，同时复用窗口自带的location对象，这样就能让jQuery正常初始化。

完整代码示例 #

const EXPORTED_SYMBOLS = ['jQuery'];

// 初始化window和location对象
var wm = Components.classes["@mozilla.org/appshell/window-mediator;1"]
                   .getService(Components.interfaces.nsIWindowMediator);
// 获取最近活跃的浏览器窗口
var window = wm.getMostRecentWindow("navigator:browser");
// 确保窗口存在，避免初始化失败
if (!window) {
    throw new Error("No active browser window found to initialize jQuery");
}
var location = window.location;

// 嵌入jQuery源码（这里替换为你使用的jQuery版本的完整代码）
(function(window, undefined) {
    /* 粘贴jQuery的minified或未压缩源码到这里 */
})(window);

// 导出jQuery对象供其他模块使用
var jQuery = window.jQuery;
// 可选：同时导出$别名
EXPORTED_SYMBOLS.push('$');
var $ = window.$;

关键注意事项 #

• 窗口有效性判断：一定要检查获取到的window是否为null，否则在没有浏览器窗口的场景下（比如扩展刚启动时）会导致模块加载失败。
• 上下文隔离：模块内的window是局部变量，不会污染其他模块的全局环境，符合XPCOM模块的隔离特性。
• 无DOM场景适配：如果你的模块需要在无浏览器窗口的后台环境运行，这种方法就不适用了，此时可以考虑使用jQuery的无DOM分支，或者手动模拟更基础的DOM环境，但这种场景比较少见。
• 版本兼容性：确保使用的jQuery版本与Firefox的版本兼容，避免出现API或语法上的冲突。

内容的提问来源于stack exchange，提问作者Vitaliy Demchuk