L'événement se déclenche lorsqu'un thème fourni en tant qu'extension de navigateur est appliqué ou supprimé, plus précisément :
- Quand un thème statique est installé
- Quand un thème dynamique appelle
theme.update()
outheme.reset()
- Quand un thème est désinstallé
Notez que cet événement n'est pas déclenché pour les thèmes intégrés.
Syntaxe
browser.theme.onUpdated.addListener(listener)
browser.theme.onUpdated.removeListener(listener)
browser.theme.onUpdated.hasListener(listener)
Les événements ont trois fonctions :
addListener(listener)
- Ajoute un écouteur à cet événement.
removeListener(listener)
- Arrête d'écouter cet événement. L'argument de
listener
est l'écouteur à supprimer. hasListener(listener)
- Vérifie si
listener
est enregistré pour cet événement. Retournetrue
s'il écoute, sinonfalse
.
Syntaxe addListener
Paramètres
callback
-
Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les paramètres suivants :
updateInfo
-
object
. Un objet contenant deux propriétés :theme
object
. Si l'événement a été déclenché parce qu'un thème fourni par une extension a été supprimé, il s'agira d'un objet vide. Si il a été déclenché parce qu'un thème fourni par une extension a été appliqué, ce sera un objettheme.Theme
représentant le thème qui a été appliqué.windowId
Facultatifinteger
. L'ID de la fenêtre pour laquelle le thème a été mis à jour. Si cette propriété n'est pas présente, cela signifie que le thème a été mise à jour globalement.
Compatibilité du navigateur
BCD tables only load in the browser
The compatibility table in 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.
Exemples
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);