Uninstalls an add-on, given its ID.

This API requires the "management"API permission.

This is an asynchronous function that returns aPromise.

Syntax

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

Parameters

id

string. ID of the add-on to uninstall.

optionsOptional

object. Object which may contain a single property,showConfirmDialog. IfshowConfirmDialog istrue, the browser will show a dialog asking the user to confirm that the add-on should be uninstalled.

• Ifid is the calling add-on's ID,showConfirmDialog defaults tofalse.
• Ifid is the ID of a different add-on, theshowConfirmDialog option is ignored and the confirmation dialog is always shown.

Return value

APromise that will be rejected with an error message if the user canceled the uninstallation.

Examples

Uninstall the add-on whose ID is "addon-id" and ask the user to confirm. In the callback, we check whether the user canceled the uninstallation or if the operation succeeded.

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);

Browser compatibility