permissions.onAdded

Fires when the extension is granted permissions.

Syntax

browser.permissions.onAdded.addListener(listener)
browser.permissions.onAdded.removeListener(listener)
browser.permissions.onAdded.hasListener(listener)

Events have three functions:

• addListener(listener)
  • : Adds a listener to this event.
• removeListener(listener)
  • : Stop listening to this event. The listener argument is the listener to remove.
• hasListener(listener)
  • : Check 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 granted.

Examples

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

browser.permissions.onAdded.addListener(handleAdded);

{{WebExtExamples}}

Browser compatibility

{{Compat}}

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