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.


let gettingWarnings =
  id                  // string



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


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

let id = "my-add-on";

function gotWarnings(warnings) {
  for (const warning of warnings) {

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