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:過濾器裡用了先行斷言、後行斷言或反向參照。
環境佔位字串
Extension.js 會在編譯期間替換輸出的.json 資產中的 $EXTENSION_* 佔位字串,與靜態 HTML 佔位字串替換使用相同流程。
最佳實務
- 讓 manifest 參考的 JSON 聚焦在瀏覽器要求的資源格式上。
- 在持續整合(CI)中驗證 JSON 資源,再進行打包。
- 在 manifest 中優先使用穩定的檔案路徑,因為每次路徑變更都會讓 dev 工作階段重新啟動編譯器。
- 對於由程式碼消費的 app 資料,建議在 JS/TS 模組中用 JSON import 處理,與 manifest 資源 JSON 分開。
後續步驟
- 繼續閱讀開發中的圖示。
- 進一步了解 manifest 開發行為。

