theme.onUpdated
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
listenerest l'écouteur à supprimer. hasListener(listener)-
Vérifie si
listenerest enregistré pour cet événement. Retournetrues'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.Themereprésentant le thème qui a été appliqué. windowIdFacultatif-
integer. 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é des navigateurs
BCD tables only load in the browser
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);