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。
示例
擴充套件程式示例
瀏覽器相容性
載入中…