跳轉到主要內容
為擴充功能的規則集與 managed schema 等功能使用 JSON 資源,並獲得驗證與可預期的輸出處理。 Extension.js 會處理 manifest 參考的 JSON 資源,針對已知功能類型進行驗證。在開發期間會監看它們,並在需要時輸出資產。

JSON 能力

JSON 支援

常見的 manifest 欄位:

在 manifest.json 中宣告 JSON 的範例

在 manifest.json 中宣告 JSON 的範例:

輸出路徑

Extension.js 依照功能情境輸出 JSON 資源(例如 DNR 與 storage schema 的輸出):

開發行為

  • Extension.js 會把 manifest 參考的 JSON 檔案加入檔案相依進行追蹤。
  • 編輯 JSON 會觸發重新編譯。
  • 當 manifest 的修改新增、移除或重新命名 JSON 參考時,正在執行的 extension dev 工作階段會自行重新啟動編譯器。

驗證行為

Extension.js 會驗證:
  • 被引用資源的 JSON 語法
  • DNR 規則集的結構(以陣列為基礎的規則集預期)
  • Managed storage schema 的結構(以物件為基礎的預期)

Chrome 拒絕的規則集

Chromium 建置會對兩種 declarativeNetRequest 規則集形態發出警告。Chrome 會因為其中任何一種拒絕載入整個擴充功能,而 Firefox 能載入同一個檔案。
  • 重複的規則 id:同一個規則集裡有兩條規則共用一個 id。
  • Chrome 無法編譯的 regexFilter:過濾器裡用了先行斷言、後行斷言或反向參照。
這兩則都是警告而不是錯誤,因為同一個檔案在 Firefox 上是合法的。Firefox 與 Safari 建置不會印出任何內容。

環境佔位字串

Extension.js 會在編譯期間替換輸出的 .json 資產中的 $EXTENSION_* 佔位字串,與靜態 HTML 佔位字串替換使用相同流程。

最佳實務

  • 讓 manifest 參考的 JSON 聚焦在瀏覽器要求的資源格式上。
  • 在持續整合(CI)中驗證 JSON 資源,再進行打包。
  • 在 manifest 中優先使用穩定的檔案路徑,因為每次路徑變更都會讓 dev 工作階段重新啟動編譯器。
  • 對於由程式碼消費的 app 資料,建議在 JS/TS 模組中用 JSON import 處理,與 manifest 資源 JSON 分開。

後續步驟