declarativeNetRequest.updateSessionRules

修改扩展程序的会话范围规则集。首先会移除 options.removeRuleIds 中列出的规则 ID,然后添加 options.addRules 中提供的规则。请注意,

  • 此更新作为原子操作进行:要麼所有指定的规则都被添加和移除,要麼返回错误。
  • 这些规则在浏览器会话之间不被持久化。
  • 可以添加的会话范围规则数量有限制:

语法

js
let rulesetUpdated = browser.declarativeNetRequest.updateSessionRules(
    options                // object
);

参数

options

包含要从动态规则中添加或删除的规则详情的对象。

addRules 可选

一个 declarativeNetRequest.Rule 数组。要添加的规则详情。

removeRuleIds 可选

一个 number 数组。要移除的规则 ID。任何无效的 ID 都将被忽略。

返回值

一个 Promise。如果请求成功,Promise 将会以无参数的形式 fulfilled。如果请求失败,Promise 将会以错误消息的形式 rejected。

示例

扩展程序示例

浏览器兼容性