declarative_net_request

类型 Object
必填
Manifest 版本 2 或更高
示例
json
"declarative_net_request" : {
  "rule_resources" : [{
    "id": "ruleset",
    "enabled": true,
    "path": "rules.json"
  }]
}

declarativeNetRequest 指定静态规则集。有关规则集数量、已启用规则集和可指定的规则的信息,请参阅 静态规则集限制

有关权限要求的信息,请参阅 权限

注意: 包含未知属性的规则,如果其他方面有效,则会被加载,即未知属性会被忽略。在 Firefox 128 之前,包含未知属性的规则被认为无效且不会被加载。

语法

"declarative_net_request" 键是一个对象,该对象必须包含 "rule_resources" 属性,这是一个数组,必须至少包含一个具有以下属性的对象:

名称 类型 描述
"id" String 一个非空字符串,唯一标识规则集。以下划线(`_`)开头的 ID 保留供内部使用。
"enabled" Boolean 规则集是否默认启用。可以使用 declarativeNetRequest.updateEnabledRulesets 方法在运行时启用或禁用规则集。
"path" String 规则集 JSON 文件的路径,相对于扩展目录。有关规则集 JSON 文件内容的信息,请参阅 declarativeNetRequest API 的 规则 部分。

示例

json
"declarative_net_request" : {
  "rule_resources" : [{
    "id": "ruleset_1",
    "enabled": true,
    "path": "rules_1.json"
  }, {
    "id": "ruleset_2",
    "enabled": false,
    "path": "rules_2.json"
  }]
}

扩展程序示例

浏览器兼容性