management.setEnabled()

啟用或停用指定的外掛。

此函式通常必須在使用者操作的上下文中呼叫,例如按鈕的點選處理程式。瀏覽器也可能會要求使用者確認更改。

此 API 需要“management”API 許可權

這是一個非同步函式,它返回一個 Promise

該函式允許啟用/停用主題外掛,但如果用於啟用或停用其他型別的 Web 擴充套件,則會返回錯誤。

語法

js
let settingEnabled = browser.management.setEnabled(
  id,              // string
  enabled         // boolean
)

引數

id

string。要啟用/停用的外掛的 ID。

enabled

boolean。是要啟用還是停用外掛。

返回值

一個 Promise,當外掛已被停用或啟用時,它將以無引數的形式完成。

示例

切換 ID 為 "my-add-on" 的外掛的啟用/停用狀態

js
let id = "my-add-on";

function toggleEnabled(id) {
  let getting = browser.management.get(id);
  getting.then((info) => {
    browser.management.setEnabled(id, !info.enabled);
  });
}

toggleEnabled(id);

擴充套件程式示例

瀏覽器相容性

注意:此 API 基於 Chromium 的 chrome.management API。本文件摘自 Chromium 程式碼中的 management.json