从 Chrome 148 开始,除了现有的 chrome 命名空间之外,所有 Chrome 扩展程序 API 还可在 browser 命名空间下使用。例如,browser.tabs.create({}) 和 chrome.tabs.create({}) 是等效的。
只要可以调用扩展程序 API,就可以使用该命名空间,包括内容脚本、Service Worker 和屏幕外文档。它指向与 chrome 相同的 API 对象,因此 chrome.tabs === browser.tabs。
browser 命名空间源自 WebExtensions 社区群组 (WECG) 的工作,该群组是一个 W3C 社区群组,浏览器供应商在其中协作制定共享扩展标准。chrome 命名空间不会消失;两个命名空间都将继续有效。
决定是否采用浏览器命名空间
如果您使用的是 webextension-polyfill,请先跳到针对 polyfill 用户的说明,然后再更改其他任何内容 - 您的答案会有所不同。
如果您要构建新的扩展程序,请将 minimum_chrome_version 设置为 "148",并无条件使用 browser;您可以停止阅读本文。本部分的其余内容适用于决定如何采用该功能的现有扩展程序。
查看用户使用的 Chrome 版本
如果您已有扩展程序,请在切换之前检查用户运行的 Chrome 版本。Chrome 会自动更新,但有些用户会停用更新,还有些用户使用的是无法运行最新版本的旧设备。使用您自己的分析数据进行确认。如果您尚未设置 Google Analytics,请参阅使用 Google Analytics 4 监控扩展程序的性能,开始设置。
然后,选择一条路径:
无条件采用
在清单中设置 minimum_chrome_version,并无条件使用 browser,无需运行时保护:
{
"minimum_chrome_version": "148"
}
提高minimum_chrome_version时,请使用分阶段发布。如果出现问题,您可以在 Chrome 应用商店中回滚扩展程序。
使用运行时防护
在扩展程序的启动代码中尽早添加以下代码段,然后再在其他任何位置引用 browser:
if (!globalThis.browser) {
globalThis.browser = chrome;
// Consider firing an analytics event here to measure how often
// your users hit this fallback path.
}
这会使 browser 成为早期版本中 chrome 的别名,因此代码的其余部分可以无条件使用 browser。
针对 polyfill 用户的说明
如果您的扩展程序使用 webextension-polyfill,则在 Chrome 148 及更高版本中,它会变为无操作。当 browser 已定义时,polyfill 会跳过封装,并假定宿主浏览器已提供该 API。
之前曾尝试在 Chrome 136 中发布该命名空间,但由于以下原因而回滚:新定义了 browser 后,polyfill 停止封装,但 Chrome 的 browser.runtime.onMessage 尚不支持 polyfill 一直提供的返回 promise 的监听器。依赖于该模式的扩展程序无法正常运行。Chrome 148 同时发布了命名空间和返回原生 promise 的 onMessage 监听器,以避免出现这种差距。
当您的用户群已迁移到 Chrome 148 后,您就可以移除 polyfill 依赖项。
其他功能
runtime.sendMessage 中的异步响应
在 Chrome 148 中,runtime.onMessage 监听器可以直接返回 Promise,以发送异步响应。无论您是使用 chrome.* 还是 browser.* 调用它,此方法都有效。
以前,进行异步响应的唯一方法是从监听器返回字面量 true,并在稍后调用 sendResponse:
// Old pattern - requires returning true to keep the channel open
chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
fetch('https://example.com')
.then(response => sendResponse({ statusCode: response.status }));
return true; // keeps the message channel open for the async response
});
现在,您可以直接返回 Promise(或使用 async 函数):
// New pattern - return a promise or use async/await
browser.runtime.onMessage.addListener(async (message, sender) => {
const response = await fetch('https://example.com');
return { statusCode: response.status };
});
return true 模式仍然有效,因此现有代码无需更改。