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
js
browser.runtime.onInstalled.addListener(listener)
browser.runtime.onInstalled.removeListener(listener)
browser.runtime.onInstalled.hasListener(listener)
Les événements ont trois fonctions :
addListener(callback)-
Ajouterun écouteur à cet événement.
removeListener(listener)-
Arrêtez d'écoutercet événement. L'argument
listenerest l'écouteur à supprimer. hasListener(listener)-
Vérifie si un
écouteurest enregistré pour cet événement. Renvoietrues'il écoute,falsesinon.
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 deraisonestshared_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 deraisonestmise à 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'extensin est installé, connectez-vous à la raison de l'installon et ouvrez https://www.reddit.com/r/CatGifs/:
js
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.