擴充功能中的 JSON 資源

​

JSON 能力

​

JSON 支援

​

在 manifest.json 中宣告 JSON 的範例

{
  "manifest_version": 3,
  "name": "My Extension",
  "version": "1.0.0",
  "declarative_net_request": {
    "rule_resources": [
      {
        "id": "ruleset_1",
        "enabled": true,
        "path": "rules/ruleset.json"
      }
    ]
  },
  "storage": {
    "managed_schema": "schema/storage-schema.json"
  }
}

​

輸出路徑

declarative_net_request/<ruleset-id>.json
storage/managed_schema.json

​

開發行為

• Extension.js 會把 manifest 參考的 JSON 檔案加入檔案相依進行追蹤。
• 編輯 JSON 會觸發重新編譯。
• 某些與 JSON 相關的 manifest 結構性變更可能需要重新啟動開發伺服器。

​

驗證行為

• 被引用資源的 JSON 語法
• DNR 規則集的結構（以陣列為基礎的規則集預期）
• Managed storage schema 的結構（以物件為基礎的預期）

​

環境佔位字串

​

最佳實務

• 讓 manifest 參考的 JSON 聚焦在瀏覽器要求的資源格式上。
• 在持續整合（CI）中驗證 JSON 資源，再進行打包。
• 在 manifest 中優先使用穩定的檔案路徑，減少開發期需要重新啟動的結構性變更。
• 對於由程式碼消費的 app 資料，建議在 JS／TS 模組中用 JSON import 處理，與 manifest 資源 JSON 分開。

​

後續步驟

• 繼續閱讀開發中的圖示。
• 進一步了解 manifest 開發行為。