runtime

Ce module fournit des informations sur votre extension et l'environnement dans lequel elle fonctionne.

Il fournit également des API de messagerie vous permettant de:

  • Communiquer entre les différentes parties de votre extension.
  • Communiquer avec d'autres extensions.
  • Communiquer avec les applications natives.

Types

runtime.Port

Représente une extrémité d'une connexion entre deux contextes spécifiques, qui peut être utilisée pour échanger des messages.

runtime.MessageSender

Contient des informations sur l'expéditeur d'un message ou d'une demande de connexion.

runtime.PlatformOs

Identifie le système d'exploitation du navigateur.

runtime.PlatformArch

Identifie l'architecture du processeur du navigateur.

runtime.PlatformInfo

Contient des informations sur la plate-forme utilisée par le navigateur.

runtime.RequestUpdateCheckStatus

Résultat d'un appel à runtime.requestUpdateCheck().

runtime.OnInstalledReason

La raison pour laquelle l'événement runtime.onInstalled est en cours d'envoi.

runtime.OnRestartRequiredReason

La raison pour laquelle l'événement runtime.onRestartRequired est en cours d'expédition.

Propriétés

runtime.lastError

Cette valeur est définie lorsqu'une fonction asynchrone a une condition d'erreur qu'elle doit signaler à son appelant

runtime.id

L'ID de l'extension

Fonctions

runtime.getBackgroundPage()

Récupère l'objet Window pour la page d'arrière-plan qui s'exécute dans l'extension en cours.

runtime.openOptionsPage()

Ouvre une page d'options de votre extension.

runtime.getManifest()

Obtient le fichier manifest.json complet, sérialisé en tant qu'objet.

runtime.getURL()

Etant donné un chemin relatif de manifest.json à une ressource empaquetée avec l'extension, renvoie une URL entièrement qualifiée.

runtime.setUninstallURL()

Définit une URL à visiter lorsque l'extension est désinstallée.

runtime.reload()

Recharge l'extension.

runtime.requestUpdateCheck()

Vérifie les mises à jour de cette extension.

runtime.connect()

Établit une connexion d'un script de contenu au processus d'extension principal ou d'une extension à une extension différente.

runtime.connectNative()

Connecte l'extension à une application native sur l'ordinateur de l'utilisateur.

runtime.sendMessage()

Envoie un seul message aux écouteurs d'événement dans votre extension ou une extension différente. Similaire à runtime.connect mais n'envoie qu'un seul message, avec une réponse facultative.

runtime.sendNativeMessage()

Envoie un seul message d'une extension à une application native.

runtime.getPlatformInfo()

Renvoie des informations sur la plate-forme actuelle.

runtime.getBrowserInfo()

Renvoie des informations sur le navigateur dans lequel cette extension est installée.

runtime.getPackageDirectoryEntry()

Renvoie un DirectoryEntry pour le répertoire du package.

Evénements

runtime.onStartup

Lancé lorsqu'un premier profil a cette extension installée. Cet événement n'est pas déclenché lorsqu'un profil de navigation privée est démarré.

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.

runtime.onSuspend

Envoyé sur la page de l'événement juste avant le déchargement de l'extension. Cela donne à l'extension l'opportunité de faire un peu de nettoyage.

runtime.onSuspendCanceled

Envoyé après runtime.onSuspend pour indiquer que l'extension ne sera pas déchargée après tout.

runtime.onUpdateAvailable

Lancé lorsqu'une mise à jour est disponible, mais n'est pas installé immédiatement car l'extension est en cours d'exécution.

runtime.onBrowserUpdateAvailable Obsolète

Lancé lorsqu'une mise à jour pour le navigateur est disponible, mais n'est pas installée immédiatement car un redémarrage du navigateur est requis.

runtime.onConnect

Lancé lorsqu'une connexion est établie avec un processus d'extension ou un script de contenu.

runtime.onConnectExternal

Lancé lorsqu'une connexion est établie avec une autre extension.

runtime.onMessage

Lancé lorsqu'un message est envoyé par un processus d'extension ou un script de contenu.

runtime.onMessageExternal

Lancé lorsqu'un message est envoyé depuis un autre poste. Ne peut pas être utilisé dans un script de contenu.

runtime.onRestartRequired

Lancé lorsque le périphérique doit être redémarré.

Compatibilité des navigateurs

BCD tables only load in the browser

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.