runtime.MessageSender

Un objet contenant des informations sur l'expéditeur d'un message ou d'une demande de connexion ; ceci est passé à l'écouteur runtime.onMessage().

C'est aussi une propriété de runtime.Port, mais seulement dans l'instance de Port passée dans les écouteurs runtime.onConnect() ou runtime.onConnectExternal().

Type

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

tabFacultatif
tabs.Tab. Le tabs.Tab qui a ouvert la connexion. Cette propriété ne sera présente que lorsque la connexion a été ouverte à partir d'un onglet (y compris les scripts de contenu).
frameIdFacultatif
integer. Le cadre qui a ouvert la connexion. Zéro pour les cadres de haut niveau, positif pour les cadres enfants.  Cela ne sera défini que lorsque l'onglet est défini.
idFacultatif
string. L'ID de l'extension qui a envoyé le message, si le message a été envoyé par une extension. Si l'expéditeur définit explicitement un ID à l'aide de la clé des applications dans manifest.json, then id  aura cette valeur. Sinon, il aura l'ID qui a été généré pour l'expéditeur.
Notez que dans Firefox, avant la version 54, cette valeur était l'ID interne de l'extension (c'est-à-dire l'UUID qui apparaît dans l'URL de l'extension).
urlFacultatif
string. L'URL de la page ou du cadre hébergeant le script qui a envoyé le message.
Si l'expéditeur est un script s'exécutant dans une page d'extension (telle qu'une  page d'arrière-plan, une page d'options, ou une action de navigateur ou une action contextuelle), l'URL sera au format "moz-extension://<extension-internal-id>/path/to/page.html". Si l'expéditeur est un script d'arrière-plan et que vous n'avez pas inclus une page d'arrière-plan, ce sera "moz-extension://<extension-internal-id>/_blank.html".
Si l'expéditeur est un script s'exécutant sur une page Web (y compris les scripts de contenu et les scripts de page normaux), alors l'url sera l'URL de la page web. Si le script s'exécute dans un iframe, url sera l'URL de l'iframe.
tlsChannelIdFacultatif
string. L'ID de canal TLS de la page ou du cadre qui a ouvert la connexion, si demandé par l'extension, et si disponible.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome 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.
urlChrome Support complet 28Edge Support complet 14
Notes
Support complet 14
Notes
Notes The `url` is missing when the message was sent by an extension view.
Firefox Support complet 45Opera Support complet 15Firefox Android Support complet 48
tlsChannelIdChrome Support complet 32Edge Aucun support NonFirefox Support complet 45Opera Support complet 19Firefox Android Support complet 48
frameIdChrome Support complet 41Edge Support complet 14Firefox Support complet 45Opera Support complet 28Firefox Android Support complet 48

Légende

Support complet  
Support complet
Aucun support  
Aucun support
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,