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