declarative_net_request

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

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

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

注意:如果规则本身有效,则包含无法识别的属性的规则将被加载,即无法识别的属性将被忽略。在 Firefox 128 之前,包含无法识别的属性的规则被认为无效且不会加载。

语法

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

名称 类型 描述
"id" 字符串 唯一标识规则集的非空字符串。以 '_' 开头的 ID 预留供内部使用。
"enabled" 布尔值 规则集是否默认启用。 declarativeNetRequest.updateEnabledRulesets 方法可用于在运行时启用或禁用规则集。
"path" 字符串 相对于扩展目录的 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"
  }]
}

示例扩展

浏览器兼容性

BCD 表格仅在浏览器中加载