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

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

Example extensions

• theme-integrated-sidebar