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 can not use the theme function of the manifest, it is incompatible

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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
ThemeChrome No support NoEdge No support NoFirefox Full support 55Opera No support NoFirefox Android No support No
getCurrentChrome No support NoEdge No support NoFirefox Full support 58Opera No support NoFirefox Android No support No
onUpdatedChrome No support NoEdge No support NoFirefox Full support 58Opera No support NoFirefox Android No support No
resetChrome No support NoEdge No support NoFirefox Full support 56Opera No support NoFirefox Android No support No
updateChrome No support NoEdge No support NoFirefox Full support 55Opera No support NoFirefox Android No support No

Legend

Full support  
Full support
No support  
No support

Example extensions

Document Tags and Contributors

Contributors to this page: Sheppy, hellosct1, wbamberg, ntim, rebloor
Last updated by: Sheppy,