management.setEnabled()

启用或禁用给定的附加组件。

此函数通常必须在用户操作的上下文中调用，例如按钮的点击处理程序。浏览器也可能会要求用户确认更改。

此 API 需要“management”API 权限。

这是一个异步函数，它返回一个Promise。

该函数允许启用/禁用主题附加组件，但如果用于启用或禁用其他类型的 Web 扩展，则会返回错误。

语法

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

参数

id

字符串。要启用/禁用的附加组件的 ID。

enabled

布尔值。是否启用或禁用附加组件。

返回值

一个Promise，当附加组件已禁用或启用时，它将以没有任何参数的方式完成。

浏览器兼容性

BCD 表仅在浏览器中加载

示例

切换 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。