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。

示例

瀏覽器相容性