The cross-browser extension framework

不必為每個瀏覽器各自維護一份 manifest 檔案。 Extension.js 讓你用前綴在同一份檔案內定義瀏覽器專屬的值，在編譯時只輸出符合當前目標的欄位。

為什麼這很重要

瀏覽器在 manifest 的關鍵領域仍有差異，例如背景設定與廠商相關的中繼資料。透過帶前綴的欄位，你可以保留一份來源 manifest.json，同時為 Chromium 家族與 Firefox 家族目標產出對應正確的輸出。

Extension.js 會掃描 manifest 鍵值，並針對所選的瀏覽器解析帶前綴的條目：

Chromium 家族目標（chrome、edge、chromium-based）會解析：chromium:、chrome:、edge:
Gecko 家族目標（firefox、gecko-based）會解析：firefox:、gecko:

當帶前綴的鍵符合當前目標時，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。