Modules

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

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple22 Oui52152115
details.id22 Oui Non Non15
details.previousVersion22 Oui555515
details.reason22 Oui525215
details.temporary Non Non5555 Non

1. Before version 55, this event is not triggered for temporarily installed add-ons.

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,