theme.onUpdated
Fires when a theme supplied as a browser extension is applied or removed. Specifically:
- when astatic theme is installed
- when adynamic theme calls
theme.update()ortheme.reset() - when a theme gets uninstalled.
This event is not fired for changes to the built-in themes.
In this article
Syntax
browser.theme.onUpdated.addListener(listener)browser.theme.onUpdated.removeListener(listener)browser.theme.onUpdated.hasListener(listener)Events have three functions:
addListener(listener)Adds a listener to this event.
removeListener(listener)Stop listening to this event. The
listenerargument is the listener to remove.hasListener(listener)Check whether
listeneris registered for this event. Returnstrueif it is listening,falseotherwise.
addListener syntax
>Parameters
listenerThe function called when this event occurs. The function is passed these arguments:
updateInfoobject. An object containing two properties:themeobject. If the event fired because an extension-supplied theme was removed, this is an empty object. If it fired because an extension-supplied theme was applied, then it is atheme.Themeobject representing the theme that was applied.windowIdOptionalinteger. The ID of the window in which the theme was updated. If this property is not present, the theme was updated in all windows.
Examples
function handleUpdated(updateInfo) { if (updateInfo.theme.colors) { console.log(`Theme was applied: ${updateInfo.theme}`); } else { console.log(`Theme was removed`); }}browser.theme.onUpdated.addListener(handleUpdated);