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,如果用户取消了卸载,则会因错误消息而被拒绝。

示例

卸载 ID 为“addon-id”的扩展程序,并要求用户确认。在回调函数中,我们检查用户是否取消了卸载,或者操作是否成功。

js
let id = "addon-id";

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

function onUninstalled() {
  console.log("Uninstalled");
}

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

浏览器兼容性

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