MDN self-hosted library · e01.org

management.uninstallSelf()

Uninstalls the calling add-on.

Open notebook · 2 cells webextension-api-function upstream source

Uninstalls the calling add-on.

This API does not require the "management" API permission.

This is an asynchronous function that returns a Promise.

Syntax

let uninstallingSelf = browser.management.uninstallSelf(
  options              // object
)

Parameters

  • options
  • : object. Object which may two properties, both optional:
    • showConfirmDialog
    • : Boolean. If showConfirmDialog is true, the browser will show a dialog asking the user to confirm that the add-on should be uninstalled. Defaults to false.
    • dialogMessage
    • : String. An extra message that will be displayed in the confirmation dialog.

Return value

A Promise that will be rejected with an error message if the user canceled uninstall.

Examples

Uninstall the add-on, asking the user to confirm. In the callback, check whether the user canceled uninstallation.

Note that we haven't passed a fulfillment handler because if uninstallation succeeds, the add-on is no longer around to handle it.

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

let uninstalling = browser.management.uninstallSelf({
  showConfirmDialog: true,
});

uninstalling.then(null, onCanceled);

The same, but also adding a custom message to the dialog:

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

let uninstalling = browser.management.uninstallSelf({
  showConfirmDialog: true,
  dialogMessage: "Testing self-uninstall",
});

uninstalling.then(null, onCanceled);

Browser compatibility

[!NOTE] This API is based on Chromium's chrome.management API. This documentation is derived from management.json in the Chromium code.