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
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é du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
MessageSenderChrome Support complet 26Edge Support complet 14Firefox Support complet 45
Notes
Support complet 45
Notes
Notes Before version 54, 'id' was the add-on's internal UUID, not the add-on ID.
Opera Support complet 15Firefox Android Support complet 48
Notes
Support complet 48
Notes
Notes Before version 54, 'id' was the add-on's internal UUID, not the add-on ID.
OnInstalledReasonChrome Support complet Oui
Notes
Support complet Oui
Notes
Notes Uses 'chrome_update' instead of 'browser_update'.
Edge Support complet 14
Notes
Support complet 14
Notes
Notes Only supports 'install' and 'update'.
Firefox Support complet 45Opera Support complet Oui
Notes
Support complet Oui
Notes
Notes Uses 'chrome_update' instead of 'browser_update'.
Firefox Android Support complet 48
OnRestartRequiredReasonChrome Support complet OuiEdge Aucun support NonFirefox Support complet 45Opera Support complet OuiFirefox Android Support complet 48
PlatformArchChrome Support complet OuiEdge Aucun support NonFirefox Support complet 45Opera Support complet OuiFirefox Android Support complet 48
PlatformInfoChrome Support complet OuiEdge Aucun support NonFirefox Support complet 45Opera Support complet OuiFirefox Android Support complet 48
PlatformNaclArchChrome Support complet OuiEdge Aucun support NonFirefox Support complet 45Opera Support complet OuiFirefox Android Support complet 48
PlatformOsChrome Support complet OuiEdge Aucun support NonFirefox Support complet 45Opera Support complet OuiFirefox Android Support complet 48
PortChrome Support complet 26Edge Support complet 15Firefox Support complet 45Opera Support complet 15Firefox Android Support complet 48
RequestUpdateCheckStatusChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Support complet OuiFirefox Android Aucun support Non
connectChrome Support complet 26Edge Support complet 14Firefox Support complet 45Opera Support complet 15Firefox Android Support complet 48
connectNativeChrome Support complet 29Edge Support complet 15Firefox Support complet 50Opera Support complet 16Firefox Android Aucun support Non
getBackgroundPageChrome Support complet 22Edge Support complet 14Firefox Support complet 45
Notes
Support complet 45
Notes
Notes If this is called from a page that is part of a private browsing window, such as a sidebar in a private window or a popup opened from a private window, then it will always return null.
Opera Support complet 15Firefox Android Support complet 48
Notes
Support complet 48
Notes
Notes If this is called from a page that is part of a private browsing window, such as a sidebar in a private window or a popup opened from a private window, then it will always return null.
getBrowserInfoChrome Aucun support NonEdge Aucun support NonFirefox Support complet 51Opera Aucun support NonFirefox Android Support complet 51
getManifestChrome Support complet 22Edge Support complet 14Firefox Support complet 45Opera Support complet 15Firefox Android Support complet 48
getPackageDirectoryEntryChrome Support complet 29Edge Aucun support NonFirefox Aucun support NonOpera Support complet 16Firefox Android Aucun support Non
getPlatformInfoChrome Support complet 29Edge Aucun support NonFirefox Support complet 45Opera Support complet 16Firefox Android Support complet 48
getURLChrome Support complet 22Edge Support complet 14Firefox Support complet 45Opera Support complet 15Firefox Android Support complet 48
idChrome Support complet 22Edge Support complet 14Firefox Support complet 45Opera Support complet 15Firefox Android Support complet 48
lastErrorChrome Support complet Oui
Notes
Support complet Oui
Notes
Notes lastError is not an Error object. Instead, it is a plain Object with the error text as the string value of the 'message' property.
Edge Support complet 14Firefox Support complet 47Opera Support complet Oui
Notes
Support complet Oui
Notes
Notes lastError is not an Error object. Instead, it is a plain Object with the error text as the string value of the 'message' property.
Firefox Android Support complet 48
onBrowserUpdateAvailable
ObsolèteNon-standard
Chrome Support complet 27Edge Aucun support NonFirefox Aucun support NonOpera Support complet 15Firefox Android Aucun support Non
onConnectChrome Support complet 26Edge Support complet 14Firefox Support complet 45Opera Support complet 15Firefox Android Support complet 48
onConnectExternalChrome Support complet 26Edge Aucun support NonFirefox Support complet 54Opera Support complet 15Firefox Android Support complet 54
onInstalledChrome 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.
onMessageChrome Support complet 26Edge Support complet 14Firefox Support complet 45Opera Support complet 15Firefox Android Support complet 48
onMessageExternalChrome Support complet 26Edge Aucun support NonFirefox Support complet 54Opera Support complet 15Firefox Android Support complet 54
onRestartRequiredChrome Support complet 29Edge Aucun support NonFirefox Aucun support NonOpera Support complet 16Firefox Android Aucun support Non
onStartupChrome Support complet 23Edge Aucun support NonFirefox Support complet 52Opera Support complet 15Firefox Android Support complet 52
onSuspendChrome Support complet 22Edge Aucun support NonFirefox Aucun support NonOpera Support complet 15Firefox Android Aucun support Non
onSuspendCanceledChrome Support complet 22Edge Aucun support NonFirefox Aucun support NonOpera Support complet 15Firefox Android Aucun support Non
onUpdateAvailableChrome Support complet 25Edge Aucun support NonFirefox Support complet 51Opera Support complet 15Firefox Android Support complet 51
openOptionsPageChrome Support complet 42Edge Aucun support NonFirefox Support complet 48Opera Support complet 29Firefox Android Support complet 57
reloadChrome Support complet 25Edge Support complet 15Firefox Support complet 51Opera Support complet 15Firefox Android Support complet 51
requestUpdateCheckChrome Support complet 25Edge Aucun support NonFirefox Aucun support NonOpera Support complet 15Firefox Android Aucun support Non
sendMessageChrome Support complet 26Edge Support complet 14
Notes
Support complet 14
Notes
Notes `runtime.onMessage` listeners in extension views receive the messages they sent.
Firefox Support complet 45Opera Support complet 15Firefox Android Support complet 48
sendNativeMessageChrome Support complet 29Edge Support complet 15Firefox Support complet 50Opera Support complet 16Firefox Android Aucun support Non
setUninstallURLChrome Support complet 41Edge Support complet 15Firefox Support complet 47Opera Support complet 28Firefox Android Support complet 48

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Voir les notes d'implémentation.
Voir les notes d'implémentation.

 
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,