theme
Enables browser extensions to update the browser theme.
To use this API, an extension must request the "theme" permission in its manifest.json file.
Note: When we set up a theme in a background file, we must declare the 'theme' permission and therefore we cannot use the theme function of the manifest, since it's not compatible.
Types
theme.Theme
- Represents the content of a theme.
Functions
theme.getCurrent()
- Gets the current browser theme.
theme.update()
- Updates the browser’s theme.
theme.reset()
- Removes any theme updates made in a call to
theme.update()
.
Events
theme.onUpdated
- Fired when the browser theme has been changed.
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 | |
Theme |
No |
No |
55 |
? |
No |
No |
? |
? |
No |
? |
? |
? |
getCurrent |
No |
No |
58 |
? |
No |
No |
? |
? |
No |
? |
? |
? |
onUpdated |
No |
No |
58 |
? |
No |
No |
? |
? |
No |
? |
? |
? |
reset |
No |
No |
56 |
? |
No |
No |
? |
? |
No |
? |
? |
? |
update |
No |
No |
55 |
? |
No |
No |
? |
? |
No |
? |
? |
? |
Example extensions
© 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/theme