runtime.onInstalled

Syntaxe

browser.runtime.onInstalled.addListener(listener);
browser.runtime.onInstalled.removeListener(listener);
browser.runtime.onInstalled.hasListener(listener);

Les événements ont trois fonctions :

addListener(callback)

Ajoute un gestionnaire d'événement à cet événement.

removeListener(listener)

Arrête d'écouter cet événement. L'argument listener est le gestionnaire d'événement à supprimer.

hasListener(listener)

Vérifie si un gestionnaire d'événement listener est enregistré pour cet événement. Renvoie true s'il écoute, false sinon.

Syntaxe addListener

Paramètres

function

La fonction de rappel appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :

details

Un objet avec les propriétés suivantes :

idFacultatif

string. L'ID de l'extension de module partagé importé mise à jour. Ceci n'est présent que si la valeur de raison est shared_module_update.

previousVersionFacultatif

string. La version précédente de l'extension vient d'être mise à jour. Ceci n'est pas présent si la valeur de raison est mise à jour.

reason

Une valeur runtime.OnInstalledReason, indiquant la raison pour laquelle cet événement est distribué.

temporary

boolean. Vrai si le module complémentaire a été installé temporairement. Par exemple, en utilisant la page "about:debugging" dans Firefox ou en utilisant web-ext run. Sinon faux.

Compatibilité des navigateurs

Exemples

Lorsque l'extension est installée, enregistrer la raison de l'installation dans la console et ouvrir https://www.reddit.com/r/CatGifs/:

function handleInstalled(details) {
  console.log(details.reason);
  browser.tabs.create({
    url: "http://chilloutandwatchsomecatgifs.com/",
  });
}

browser.runtime.onInstalled.addListener(handleInstalled);

Exemples d'extensions

• runtime-examples
• userScripts-mv3