Back to Content

permissions.onRemoved

files/en-us/mozilla/add-ons/webextensions/api/permissions/onremoved/index.md

latest1.4 KB
Original Source

Fires when permissions are removed from the extension.

Syntax

js-nolint
browser.permissions.onRemoved.addListener(listener)
browser.permissions.onRemoved.removeListener(listener)
browser.permissions.onRemoved.hasListener(listener)

Events have three functions:

  • addListener(listener)
    • : Adds a listener to this event.
  • removeListener(listener)
    • : Stops listening to this event. The listener argument is the listener to remove.
  • hasListener(listener)
    • : Checks whether listener is registered for this event. Returns true if it is listening, false otherwise.

addListener syntax

Parameters

  • listener
    • : The function called when this event occurs. The function is passed this argument:
      • permissions
        • : {{WebExtAPIRef("permissions.Permissions")}} object containing the permissions that were removed.

Examples

js
function handleRemoved(permissions) {
  console.log(`Removed API permissions: ${permissions.permissions}`);
  console.log(`Removed host permissions: ${permissions.origins}`);
  console.log(
    `Removed data collection permissions: ${permissions.data_collection}`,
  );
}

browser.permissions.onRemoved.addListener(handleRemoved);

{{WebExtExamples}}

Browser compatibility

{{Compat}}

[!NOTE] This API is based on Chromium's chrome.permissions API.