management.getPermissionWarningsById()

When the user installs or upgrades an add-on, the browser may warn the user about any particularly powerful permissions that the add-on has requested. Not all permissions result in warnings, and this behavior is not standardized across browsers.

Given the ID of an add-on, this function returns the permission warnings for it as an array of strings.

This API requires the "management" API permission.

This is an asynchronous function that returns a Promise.

Syntax

js
let gettingWarnings = browser.management.getPermissionWarningsById(
  id                  // string
)

Parameters

id

string. ID of the add-on whose permission warnings you want to retrieve.

Return value

A Promise that will be fulfilled with an array of strings, each of which contains the text of a permission warning.

Browser compatibility

BCD tables only load in the browser

Examples

Log the permission warnings for the add-on whose ID is "my-add-on":

js
let id = "my-add-on";

function gotWarnings(warnings) {
  for (const warning of warnings) {
    console.log(warning);
  }
}

browser.management.getPermissionWarningsById(id).then(gotWarnings);

Note: This API is based on Chromium's chrome.management API. This documentation is derived from management.json in the Chromium code.