declarativeNetRequest.updateEnabledRulesets
更新扩展的静态规则集。首先会停用 options.disableRulesetIds 中列出的规则集 ID,然后激活 options.enableRulesetIds 中列出的规则集。请注意,已启用的静态规则集在不同会话之间会持久化,但在扩展更新之间不会。也就是说,每次扩展更新时,declarative_net_request.rule_resources manifest 键 会决定已启用静态规则集的集合。
注意:在 Firefox 132 及更早版本中,如果在安装时未注册任何静态或动态规则,浏览器重启后静态规则集将不会加载(Firefox bug 1921353)。解决方法是确保 declarative_net_request manifest 键至少包含一个已启用的规则集。
语法
js
let updatedRulesets = browser.declarativeNetRequest.updateEnabledRulesets(
options // object
);
参数
options-
一个对象,用于详细说明要激活或停用的扩展静态规则集。
disableRulesetIds可选-
一个
string数组。要停用的静态规则集的 ID。 enableRulesetIds可选-
一个
string数组。要激活的静态规则集的 ID。
返回值
一个 Promise。如果请求成功,Promise 将会以无参数的形式 fulfilled。如果请求失败,Promise 将会以错误消息的形式 rejected。
示例
浏览器兼容性
加载中…