首先,重要的警告:
-
警告!由于架构限制,如果在其编译(如未闭合括号之类的语法错误)或初始化(例如访问未定义的变量)期间发生未处理的异常,则无法注册服务工作者) 所以我们将把代码包装在try/catch 中。请注意,在 Chrome 93 之前,该错误并未显示在任何地方(它是 bug),现在它显示在 chrome://extensions 页面的扩展卡上的错误列表中。
-
警告!工作文件必须在根路径in Chrome versions older than 93。
-
警告! 不要导入像 jQuery 这样的基于 DOM 的库,因为 service worker 没有 DOM,所以没有 document、XMLHttpRequest 等等开。
此内置函数同步获取并运行脚本,以便它们的全局变量和函数立即可用。
manifest.json:
"background": { "service_worker": "bg-loader.js" },
bg-loader.js 只是单独文件中实际代码的 try/catch 包装器:
try {
importScripts('/path/file.js', '/path2/file2.js' /*, and so on */);
} catch (e) {
console.error(e);
}
如果某些文件抛出错误,则不会导入后续文件。如果您想忽略此类错误并继续导入,请将该文件单独导入到其自己的 try-catch 块中。
不要忘记指定文件扩展名,通常是.js 或.mjs。
1b。监听器中的 importScripts
根据规范,我们必须使用 service worker 的 install 事件并导入我们希望稍后能够在异步事件中导入的所有脚本(从技术上讲,初始任务之外的任何内容 JS 事件循环的 em>)。此处理程序仅在安装或更新扩展或重新加载解压缩的扩展时调用(因为它等于更新)。
这在 MV3 中很复杂,因为服务工作者是为 Web 设计的,远程脚本可能无法离线使用。希望它会在crbug/1198822 中得到简化。
另请参阅:webpack-target-webextension WebPack 插件。
self.oninstall = () => {
tryImport('/js/some-complex-script.js');
};
function tryImport(...fileNames) {
try {
importScripts(...fileNames);
return true;
} catch (e) {
console.error(e);
}
}
chrome.runtime.onMessage.addListener((msg, sender, sendResponse) => {
if (msg.action === 'somethingComplex') {
if (tryImport('/js/some-complex-script.js')) {
// calling a global function from some-complex-script.js
someComplexScriptAsyncHandler(msg, sender, sendResponse);
return true;
}
}
});
2。 Chrome 92 及更高版本中的 ES 模块
通过在 manifest.json 中的 background 声明中添加 "type": "module" 启用。
manifest.json:
"background": { "service_worker": "bg.js", "type": "module" },
"minimum_chrome_version": 92,
bg.js:
模块名称必须以路径开头并以 .js 或 .mjs 之类的扩展名结尾
import {foo} from '/path/file.js';
import './file2.js';
// each imported module should also use try/catch for their own init
try { init(); } catch (e) { console.error(e); }
function init() {
// .........
}