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)

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

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/:

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.