management.setEnabled()
启用或禁用给定的附加组件。
该函数通常必须在用户操作的上下文中调用,例如按钮的点击处理器。浏览器可能还会要求用户确认更改。
此 API 需要“management”API 权限。
这是一个返回 Promise
的异步函数。
该函数支持启用或禁用主题附加组件,但如果用于启用或禁用其它类型的 Web 扩展,将会返回错误。
语法
js
let settingEnabled = browser.management.setEnabled(
id, // 字符串
enabled // 布尔值
)
参数
返回值
Promise
,当附加组件已被禁用或启用时将不带参数地兑现。
浏览器兼容性
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
setEnabled |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- See implementation notes.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
示例
切换 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
。