From 3a4a57c8a939997afbca4244200d33ccda5d5d49 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Wed, 4 Dec 2024 19:47:23 +0800 Subject: [PATCH 1/2] feat: update translation --- .../api/management/uninstall/index.md | 97 +++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/management/uninstall/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/management/uninstall/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/management/uninstall/index.md new file mode 100644 index 00000000000000..33b412388c1fc5 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/management/uninstall/index.md @@ -0,0 +1,97 @@ +--- +title: management.uninstall() +slug: Mozilla/Add-ons/WebExtensions/API/management/uninstall +l10n: + sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 +--- + +{{AddonSidebar}} + +卸载给定 ID 的拓展。 + +该 API 需要“management”[API 权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions)。 + +这是一个异步函数,返回一个 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)。 + +## 语法 + +```js-nolint +let uninstalling = browser.management.uninstall( + id, // 字符串 + options // 对象 +) +``` + +### 参数 + +- `id` + - : `string`,要卸载的拓展的 ID。 +- `options` {{optional_inline}} + - : `object`,可能包含一个属性 `showConfirmDialog` 的对象。如果 `showConfirmDialog` 为 `true`,浏览器将显示一个对话框询问用户是否确认卸载该拓展。 + + + +- 如果 `id` 是调用该方法的拓展的 ID,`showConfirmDialog` 默认为 `false`。 +- 如果 `id` 是其他拓展的 ID,则 `showConfirmDialog` 选项将被忽略,并且确认对话框总是会显示。 + +### 返回值 + +[`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise)。如果用户取消卸载,则 Promise 会被拒绝并返回一个错误消息。 + +## 浏览器兼容性 + +{{Compat}} + +## 示例 + +卸载 ID 为“addon-id”的拓展并询问用户确认。在回调中检查用户是否取消了卸载,以及拓展的卸载是否成功。 + +```js +let id = "addon-id"; + +function onCanceled(error) { + console.log(`取消卸载:${error}`); +} + +function onUninstalled() { + console.log("拓展已卸载"); +} + +let uninstalling = browser.management.uninstall(id); +uninstalling.then(onUninstalled, onCanceled); +``` + +{{WebExtExamples}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.management`](https://developer.chrome.google.cn/docs/extensions/reference/api/management#method-uninstall) API。本文衍生自 Chromium 代码中的 [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json)。 + + From 7d59f05b9c5668d7736f531c2680fe1d4795264e Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 9 Dec 2024 19:40:13 +0800 Subject: [PATCH 2/2] Update index.md --- .../api/management/uninstall/index.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/management/uninstall/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/management/uninstall/index.md index 33b412388c1fc5..b3012bd6ee9dd8 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/management/uninstall/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/management/uninstall/index.md @@ -7,7 +7,7 @@ l10n: {{AddonSidebar}} -卸载给定 ID 的拓展。 +卸载给定 ID 的附加组件。 该 API 需要“management”[API 权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions)。 @@ -25,14 +25,14 @@ let uninstalling = browser.management.uninstall( ### 参数 - `id` - - : `string`,要卸载的拓展的 ID。 + - : `string`,要卸载的附加组件的 ID。 - `options` {{optional_inline}} - - : `object`,可能包含一个属性 `showConfirmDialog` 的对象。如果 `showConfirmDialog` 为 `true`,浏览器将显示一个对话框询问用户是否确认卸载该拓展。 + - : `object`,可能包含单一属性 `showConfirmDialog` 的对象。如果 `showConfirmDialog` 为 `true`,浏览器将显示一个对话框询问用户是否确认卸载该附加组件。 -- 如果 `id` 是调用该方法的拓展的 ID,`showConfirmDialog` 默认为 `false`。 -- 如果 `id` 是其他拓展的 ID,则 `showConfirmDialog` 选项将被忽略,并且确认对话框总是会显示。 +- 如果 `id` 是调用该方法的附加组件的 ID,`showConfirmDialog` 默认为 `false`。 +- 如果 `id` 是其他附加组件的 ID,则 `showConfirmDialog` 选项将被忽略,并且确认对话框总是会显示。 ### 返回值 @@ -44,7 +44,7 @@ let uninstalling = browser.management.uninstall( ## 示例 -卸载 ID 为“addon-id”的拓展并询问用户确认。在回调中检查用户是否取消了卸载,以及拓展的卸载是否成功。 +卸载 ID 为“addon-id”的附加组件并询问用户确认。在回调中检查用户是否取消了卸载,以及附加组件的卸载是否成功。 ```js let id = "addon-id"; @@ -54,7 +54,7 @@ function onCanceled(error) { } function onUninstalled() { - console.log("拓展已卸载"); + console.log("附加组件已被卸载"); } let uninstalling = browser.management.uninstall(id);