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() ou theme.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. Retourne true s'il écoute, sinon false.

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 objet theme.Theme repré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é du navigateur

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);

Example extensions

theme-integrated-sidebar