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)
Ajouterun écouteur à cet événement.
removeListener(listener)
Arrêtez d'écoutercet événement. L'argument listener est l'écouteur à supprimer.
hasListener(listener)
Vérifie si un écouteur 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é du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet 22Edge Support complet 14Firefox Support complet 52
Notes
Support complet 52
Notes
Notes Before version 55, this event is not triggered for temporarily installed add-ons.
Opera Support complet 15Firefox Android Support complet 52
Notes
Support complet 52
Notes
Notes Before version 55, this event is not triggered for temporarily installed add-ons.
details.idChrome Support complet 22Edge Support complet 14Firefox Aucun support NonOpera Support complet 15Firefox Android Aucun support Non
details.previousVersionChrome Support complet 22Edge Support complet 14Firefox Support complet 55Opera Support complet 15Firefox Android Support complet 55
details.reasonChrome Support complet 22Edge Support complet 14Firefox Support complet 52Opera Support complet 15Firefox Android Support complet 52
details.temporaryChrome Aucun support NonEdge Aucun support NonFirefox Support complet 55Opera Aucun support NonFirefox Android Support complet 55

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Exemples

Lorsque l'extensin est installé, connectez-vous à la raison de l'installon et ouvrez 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

Remerciements :

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.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,