declarativeNetRequest.updateSessionRules
修改扩展程序的会话范围规则集。首先会移除 options.removeRuleIds 中列出的规则 ID,然后添加 options.addRules 中提供的规则。请注意,
- 此更新作为原子操作进行:要麼所有指定的规则都被添加和移除,要麼返回错误。
- 这些规则在浏览器会话之间不被持久化。
- 可以添加的会话范围规则数量有限制:
- 在 Safari 和 Chrome 119 及更早版本中,限制为
MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES的值,用于动态和会话范围规则的总和。 - 在 Firefox 127 及更早版本中,限制为
MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES的值。 - 从 Chrome 120 和 Firefox 128 开始,限制为
MAX_NUMBER_OF_SESSION_RULES的值。
- 在 Safari 和 Chrome 119 及更早版本中,限制为
语法
js
let rulesetUpdated = browser.declarativeNetRequest.updateSessionRules(
options // object
);
参数
options-
包含要从动态规则中添加或删除的规则详情的对象。
addRules可选-
一个
declarativeNetRequest.Rule数组。要添加的规则详情。 removeRuleIds可选-
一个
number数组。要移除的规则 ID。任何无效的 ID 都将被忽略。
返回值
一个 Promise。如果请求成功,Promise 将会以无参数的形式 fulfilled。如果请求失败,Promise 将会以错误消息的形式 rejected。
示例
扩展程序示例
浏览器兼容性
加载中…