The cross-browser extension framework

不必为每个浏览器维护单独的 manifest 文件。 Extension.js 允许你用前缀在同一份文件里声明浏览器特定的值，然后在编译时只输出与当前目标匹配的字段。

为什么重要

浏览器之间在 manifest 的几个关键区域仍有差异，比如后台脚本配置和厂商元数据。带前缀的字段让你能保留一份源 manifest.json，同时为 Chromium 系和 Firefox 系目标生成各自正确的产物。

Extension.js 扫描 manifest 的键，并按所选浏览器解析带前缀的条目：

当某个带前缀的键匹配当前目标时，Extension.js 会在输出的 manifest 中把它重写为不带前缀的键。

{
  "chromium:background": {
    "service_worker": "sw.js"
  }
}

{
  "firefox:background": {
    "scripts": ["sw.js"]
  }
}

你还可以在同一个浏览器家族内针对特定厂商版本：

{
  "chrome:action": {
    "default_title": "Chrome variant"
  },
  "edge:action": {
    "default_title": "Edge variant"
  }
}

这样，service_worker 只会出现在 Chromium 系产物里，而 Firefox 产物里则保留 background.scripts。支持的前缀映射：

前缀	包含的目标浏览器
`chromium:`	`chrome`、`edge`、`chromium-based`
`chrome:`	`chrome`、`chromium-based`
`edge:`	`edge`、`chromium-based`
`firefox:`	`firefox`、`gecko-based`、`firefox-based`
`gecko:`	`firefox`、`gecko-based`、`firefox-based`

它适用于 manifest 中任意层级的任何字段，包括 permissions、content_scripts 和 background。