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 :
tab
Facultatif-
tabs.Tab
. Letabs.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). frameId
Facultatif-
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. id
Facultatif-
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, thenid
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). url
Facultatif-
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>/_generated_background_page.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. tlsChannelId
Facultatif-
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é des navigateurs
BCD tables only load in the browser
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.