runtime.onInstalled
Lancé lorsque l'extension est installée pour la première fois, lorsque l'extension est mise à jour vers une nouvelle version et lorsque le navigateur est mis à jour vers une nouvelle version.
Notez que runtime.onInstalled
n'est pas la même chose management.onInstalled
. L'événement runtime.onInstalled
est déclenché uniquement pour votre extension. L'événement browser.management.onInstalled
est déclenché pour toutes les extensions.
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. Renvoietrue
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 :
id
Facultatif-
string
. L'ID de l'extension de module partagé importé mise à jour. Ceci n'est présent que si la valeur deraison
estshared_module_update
. previousVersion
Facultatif-
string
. La version précédente de l'extension vient d'être mise à jour. Ceci n'est pas présent si la valeur deraison
estmise à 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
BCD tables only load in the browser
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);
Example extensions
Note :
Cette API est basée sur l'API Chromium chrome.runtime
. Cette documentation est dérivée de runtime.json
dans le code de Chromium code.
Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.