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。

示例

浏览器兼容性