management.uninstall()

卸载给定 ID 的附加组件。

此 API 需要“management”API 权限

这是一个异步函数,它返回一个Promise

语法

js
let uninstalling = browser.management.uninstall(
  id,                  // string
  options              // object
)

参数

id

string. 要卸载的附加组件的 ID。

options 可选

object. 对象,可能包含单个属性 showConfirmDialog。如果 showConfirmDialogtrue,则浏览器将显示一个对话框,要求用户确认是否应卸载附加组件。

  • 如果 id 是调用附加组件的 ID,则 showConfirmDialog 默认为 false
  • 如果 id 是另一个附加组件的 ID,则忽略 showConfirmDialog 选项,始终显示确认对话框。

返回值

一个Promise,如果用户取消卸载,则将被拒绝并显示错误消息。

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

示例

卸载 ID 为“my-addon-id”的附加组件,并要求用户确认。在回调函数中,检查用户是否取消了卸载。

请注意,我们没有传递 fulfillment 处理程序,因为如果卸载成功,附加组件将不再存在以处理它。

js
let id = "my-addon-id";

function onCanceled(error) {
  console.log(`Uninstall canceled: ${error}`);
}

let uninstalling = browser.management.uninstall(id);
uninstalling.then(null, onCanceled);

注意:此 API 基于 Chromium 的chrome.management API。本文档源自 Chromium 代码中的management.json