declarative_net_request
| 类型 | Object |
|---|---|
| 必填 | 否 |
| Manifest 版本 | 2 或更高 |
| 示例 |
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"
}]
}
扩展程序示例
浏览器兼容性
加载中…