management
Get information about installed add-ons.
With the management API you can:
- get information about installed add-ons
- enable/disable add-ons
- uninstall add-ons
- find out which permission warnings are given for particular add-ons or manifests
- get notifications of add-ons being installed, uninstalled, enabled, or disabled.
Most of these operations require the "management" API permission. Operations that don't provide access to other add-ons don't require this permission.
Types
management.ExtensionInfo- An object that contains information about an installed add-on.
Functions
management.getAll()- Returns information about all installed add-ons.
management.get()- Returns information about a particular add-on, given its ID.
management.getSelf()- Returns information about the calling add-on.
management.install()- Installs a particular theme, given its URL at addons.mozilla.org.
management.uninstall()- Uninstalls a particular add-on, given its ID.
management.uninstallSelf()- Uninstalls the calling add-on.
management.getPermissionWarningsById()- Get the set of permission warnings for a particular add-on, given its ID.
management.getPermissionWarningsByManifest()- Get the set of permission warnings that would be displayed for the given manifest string.
management.setEnabled()- Enable/disable a particular add-on, given its ID.
Events
management.onInstalled- Fired when an add-on is installed.
management.onUninstalled- Fired when an add-on is uninstalled.
management.onEnabled- Fired when an add-on is enabled.
management.onDisabled- Fired when an add-on is disabled.
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
ExtensionInfo |
Yes |
79 |
51 |
? |
Yes |
No |
? |
? |
51 |
? |
? |
? |
get |
Yes |
79 |
56 |
? |
Yes |
No |
? |
? |
56 |
? |
? |
? |
getAll |
Yes |
79 |
55
Before version 56, only extensions whose 'type' is 'theme' are returned.
|
? |
Yes |
No |
? |
? |
55
Before version 56, only extensions whose 'type' is 'theme' are returned.
|
? |
? |
? |
getPermissionWarningsById |
Yes |
79 |
No |
? |
Yes |
No |
? |
? |
No |
? |
? |
? |
getPermissionWarningsByManifest |
Yes |
79 |
No |
? |
Yes |
No |
? |
? |
No |
? |
? |
? |
getSelf |
Yes |
79 |
51 |
? |
No |
No |
? |
? |
51 |
? |
? |
? |
install |
No |
No |
63
The installable file pointed to by
url must be a theme, and not a normal browser extension. |
? |
No |
No |
? |
? |
63
The installable file pointed to by
url must be a theme, and not a normal browser extension. |
? |
? |
? |
onDisabled |
Yes |
79 |
55
Before version 56, only extensions whose
type is 'theme' are supported. |
? |
Yes |
No |
? |
? |
55
Before version 56, only extensions whose
'type' is 'theme'
|
? |
? |
? |
onEnabled |
Yes |
79 |
55
Before version 56, only extensions whose
type is 'theme' are supported. |
? |
Yes |
No |
? |
? |
55
Before version 56, only extensions whose
type is 'theme' are supported. |
? |
? |
? |
onInstalled |
Yes |
79 |
55
Before version 56, only extensions whose
type is 'theme' are supported. |
? |
Yes |
No |
? |
? |
55
Before version 56, only extensions whose
type is 'theme' are supported. |
? |
? |
? |
onUninstalled |
Yes |
79 |
55
["Before version 56, only extensions whose
type is 'theme' are supported.", "This event is not emitted when the extension is in the \"pending uninstall\" state. The event is emitted as expected once the extension is completely removed (for example, when the about:addons tab is closed)."] |
? |
Yes |
No |
? |
? |
55
["Before version 56, only extensions whose
type is 'theme' are supported.", "This event is not emitted when the extension is in the \"pending uninstall\" state. The event is emitted as expected once the extension is completely removed (for example, when the about:addons tab is closed)."] |
? |
? |
? |
setEnabled |
Yes |
79 |
55
Only extensions whose 'type' is 'theme' can be enabled and disabled.
|
? |
Yes |
No |
? |
? |
55
Only extensions whose 'type' is 'theme' can be enabled and disabled.
|
? |
? |
? |
uninstall |
Yes |
79 |
No |
? |
Yes |
No |
? |
? |
No |
? |
? |
? |
uninstallSelf |
Yes |
79 |
51 |
? |
Yes |
No |
? |
? |
51 |
? |
? |
? |
Example extensions
Note: This API is based on Chromium's chrome.management API. This documentation is derived from management.json in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/management