runtime.MessageSender
Ein Objekt, das Informationen über den Absender einer Nachricht oder einer Verbindungsanfrage enthält, die an den runtime.onMessage()
Listener übergeben wird.
Es ist auch eine Eigenschaft von runtime.Port
, jedoch nur in der Port
Instanz, die an die runtime.onConnect()
oder runtime.onConnectExternal()
Listener übergeben wird.
Typ
Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:
documentId
Optional-
string
. Eine UUID des Dokuments, das die Verbindung geöffnet hat. documentLifecycle
Optional-
string
. Der Lebenszykluszustand des Dokuments, das die Verbindung geöffnet hat, als der Port erstellt wurde. Beachten Sie, dass sich der Lebenszykluszustand des Dokuments geändert haben kann, seit der Port erstellt wurde. frameId
Optional-
integer
. Das Frame, das die Verbindung geöffnet hat. Null für oberste Frames, positiv für untergeordnete Frames. Dies wird nur gesetzt, wenntab
gesetzt ist. id
Optional-
string
. Die ID der Erweiterung, die die Nachricht gesendet hat, falls die Nachricht von einer Erweiterung gesendet wurde. Wenn der Absender eine ID explizit über den Schlüssel browser_specific_settings in manifest.json gesetzt hat, dann hatid
diesen Wert. Ansonsten hat es die generierte ID des Absenders. origin
Optional-
string
. Der Ursprung der Seite oder des Frames, das die Verbindung geöffnet hat. Es kann vomurl
-Attribut abweichen (z. B. about:blank) oder undurchsichtig sein (z. B. sandboxed iframes). Dies ist nützlich, um zu bestimmen, ob der Ursprung vertrauenswürdig ist, falls dies nicht offensichtlich aus der URL hervorgeht. tab
Optional-
tabs.Tab
. Dertabs.Tab
der die Verbindung geöffnet hat. Diese Eigenschaft ist nur vorhanden, wenn die Verbindung von einem Tab (einschließlich Inhaltsskripten) geöffnet wurde. tlsChannelId
Optional-
string
. Die TLS-Kanal-ID der Seite oder des Frames, die die Verbindung geöffnet hat, falls von der Erweiterung angefordert und verfügbar. url
Optional-
string
. Die URL der Seite oder des Frames, die das Skript hostet, das die Nachricht gesendet hat.Wenn der Absender ein Skript ist, das in einer Erweiterungsseite läuft (zum Beispiel ein Hintergrundseite, eine Optionsseite oder ein Popup einer Browseraktion oder Seitenaktion), hat die URL die Form
"moz-extension://<extension-internal-id>/path/to/page.html"
. Wenn der Absender ein Hintergrundskript ist und Sie keine Hintergrundseite eingeschlossen haben, ist sie"moz-extension://<extension-internal-id>/_generated_background_page.html"
.Wenn der Absender ein Skript ist, das in einer Webseite läuft (einschließlich Inhalts- und normalen Seitenskripten), dann ist
url
die URL der Webseite. Wenn das Skript in einem iframe ausgeführt wird, isturl
die URL des iframes. userScriptWorldId
Optional-
string
. DieworldId
derUSER_SCRIPT
Welt, die die Nachricht gesendet hat. Nur vorhanden inruntime.onUserScriptMessage
und inport.sender
fürruntime.onUserScriptConnect
.
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.runtime
API von Chromium. Diese Dokumentation stammt aus runtime.json
im Chromium-Code.