From a599c84a3dd94c0a9b46d4d07aacccdcfcbd57cc Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 18 Dec 2024 15:53:40 +0800 Subject: [PATCH] zh-CN: create `management.onUninstalled()` (#24947) Co-authored-by: A1lo --- .../api/management/onuninstalled/index.md | 89 +++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/management/onuninstalled/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/management/onuninstalled/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/management/onuninstalled/index.md new file mode 100644 index 00000000000000..696e24eb111eb9 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/management/onuninstalled/index.md @@ -0,0 +1,89 @@ +--- +title: management.onUninstalled() +slug: Mozilla/Add-ons/WebExtensions/API/management/onUninstalled +l10n: + sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 +--- + +{{AddonSidebar}} + +在附加组件被卸载时触发。 + +此 API 需要“management”[API 权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions)。 + +## 语法 + +```js-nolint +browser.management.onUninstalled.addListener(listener) +browser.management.onUninstalled.removeListener(listener) +browser.management.onUninstalled.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.onUninstalled.addListener((info) => { + console.log(`${info.name} 被卸载`); +}); +``` + +{{WebExtExamples}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.management`](https://developer.chrome.google.cn/docs/extensions/reference/api/management#event-onUninstalled) API。本文衍生自 Chromium 代码中的 [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json)。 + +