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
Report problems with this compatibility data on GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
ExtensionInfo | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support51 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support51 |
ExtensionInfo.disabledReason | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
ExtensionInfo.offlineEnabled | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
ExtensionInfo.type | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55 |
ExtensionInfo.versionName | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
get | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support56 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support56 |
getAll | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55
|
getPermissionWarningsById | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
getPermissionWarningsByManifest | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
getSelf | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support51 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support51 |
install | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support63
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support63
|
onDisabled | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55
|
onEnabled | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55
|
onInstalled | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55
|
onUninstalled | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55
|
setEnabled | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support55
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support55
|
uninstall | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
uninstallSelf | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support51 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support51 |
uninstallSelf.dialogMessage | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support51 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support51 |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Example extensions
Acknowledgements
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.