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 with JavaScript enabled. Enable JavaScript to view data.

Example extensions
------------------

* beastify
* content-script-register
* cookie-bg-picker
* devtools-panels
* export-helpers
* favourite-colour
* find-across-tabs
* imagify
* menu-demo
* mocha-client-tests
* native-messaging
* notify-link-clicks-i18n
* permissions
* runtime-examples
* store-collected-images
* user-script-register
* webpack-modules

**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.