W3cubDocs

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