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。

示例

擴充套件程式示例

瀏覽器相容性