扩展中的 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 中优先使用稳定的文件路径，减少开发期需要重启的结构性变更。
• 对于代码消费的应用数据，请把 JS/TS 模块中的 JSON 导入与 manifest 资源 JSON 分开处理。

​

下一步

• 继续阅读 开发中的图标。
• 进一步了解 manifest 开发行为。