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

Exemples d'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.

Help improve MDN

Learn how to contribute

Cette page a été modifiée le ⁨7 sept. 2025⁩ par les contributeurs du MDN.

View this page on GitHub • Report a problem with this content