diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/management/onenabled/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/management/onenabled/index.md new file mode 100644 index 00000000000000..ccd19bc4c7ae0b --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/management/onenabled/index.md @@ -0,0 +1,89 @@ +--- +title: management.onEnabled() +slug: Mozilla/Add-ons/WebExtensions/API/management/onEnabled +l10n: + sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 +--- + +{{AddonSidebar}} + +该事件监听器在 `enabled` 事件被触发时调用,表示一个附加组件现在已被启用。 + +此 API 需要“management”[API 权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions)。 + +## 语法 + +```js-nolint +browser.management.onEnabled.addListener(listener) +browser.management.onEnabled.removeListener(listener) +browser.management.onEnabled.hasListener(listener) +``` + +事件有三个函数: + +- `addListener(listener)` + - : 向此事件添加监听器。 +- `removeListener(listener)` + - : 停止监听此事件。`listener` 参数是要移除的监听器。 +- `hasListener(listener)` + - : 检查是否已为此事件注册了 `listener`。如果正在监听,则返回 `true`,否则返回 `false`。 + +## addListener 语法 + +### 参数 + +- `listener` + + - : 在此事件发生时调用的函数。此函数接收以下参数: + + - `info` + - : [`ExtensionInfo`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/API/management/ExtensionInfo),关于已安装的附加组件的信息。 + +## 浏览器兼容性 + +{{Compat}} + +## 示例 + +打印被启用的附加组件的名称: + +```js +browser.management.onEnabled.addListener((info) => { + console.log(`${info.name} 被启用`); +}); +``` + +{{WebExtExamples}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.management`](https://developer.chrome.google.cn/docs/extensions/reference/api/management#event-onEnabled) API。本文衍生自 Chromium 代码中的 [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json)。 + +