runtime.MessageSender
Ein Objekt mit Informationen über den Absender einer Nachricht oder Verbindungsanfrage, das an den Listener runtime.onMessage() übergeben wird.
Verfügbar für:
- Verbindungen in den Listenern
runtime.onConnect,runtime.onConnectExternalundruntime.onUserScriptConnect. In den Listenernruntime.onConnect()undruntime.onConnectExternal()ist es eine Eigenschaft des Argumentsport(runtime.Port). - Nachrichten in den Listenern
runtime.onMessage,runtime.onMessageExternalundruntime.onUserScriptMessage.
Typ
Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:
documentIdOptional-
string. Eine UUID des Dokuments, das die Verbindung geöffnet hat. Weitere Informationen finden Sie im Artikel Mit documentId arbeiten. documentLifecycleOptional-
string. Der Lebenszykluszustand des Dokuments, das die Verbindung geöffnet hat, zum Zeitpunkt der Erstellung des Ports. Beachten Sie, dass sich der Lebenszykluszustand des Dokuments seitdem geändert haben kann. frameIdOptional-
integer. Der Frame, der die Verbindung geöffnet hat. Null für Frames der obersten Ebene, ein positiver Wert für untergeordnete Frames. Diese Eigenschaft ist nur gesetzt, wenntabgesetzt ist. idOptional-
string. Die ID der Erweiterung, die die Nachricht gesendet hat, sofern die Nachricht von einer Erweiterung gesendet wurde. Wenn für den Absender über den Schlüssel browser_specific_settings in manifest.json ausdrücklich eine ID festgelegt wurde, hatiddiesen Wert. Andernfalls enthält die Eigenschaft die für den Absender generierte ID. originOptional-
string. Der Ursprung der Seite oder des Frames, die bzw. der die Verbindung geöffnet hat. Er kann von der Eigenschafturlabweichen (z. B. bei about:blank) oder opak sein (z. B. bei sandboxed iframes). Damit lässt sich beurteilen, ob der Ursprung vertrauenswürdig ist, wenn dies aus der URL nicht ersichtlich ist. tabOptional-
tabs.Tab. Dastabs.Tab, das die Verbindung geöffnet hat. Diese Eigenschaft ist nur vorhanden, wenn die Verbindung von einem Tab aus geöffnet wurde (einschließlich Content-Scripts). tlsChannelIdOptional-
string. Die TLS-Kanal-ID der Seite oder des Frames, die bzw. der die Verbindung geöffnet hat, sofern sie von der Erweiterung angefordert wurde und verfügbar ist. urlOptional-
string. Die URL der Seite oder des Frames, in der bzw. dem das Skript ausgeführt wird, das die Nachricht gesendet hat.Wenn der Absender ein Skript ist, das auf einer Erweiterungsseite ausgeführt wird (etwa auf einer Hintergrundseite, einer Optionsseite oder in einem Popup einer Browser-Aktion 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 eingebunden haben, lautet sie"moz-extension://<extension-internal-id>/_generated_background_page.html".Wenn der Absender ein Skript ist, das auf einer Webseite ausgeführt wird (einschließlich Content-Scripts und gewöhnlicher Seitenskripte), ist
urldie URL der Webseite. Wird das Skript in einem iframe ausgeführt, isturldie URL des iframes. userScriptWorldIdOptional-
string. DieworldIdderUSER_SCRIPT-Welt, die die Nachricht gesendet hat. Nur inruntime.onUserScriptMessageund inport.senderfürruntime.onUserScriptConnectvorhanden. windowIdOptional-
integer. Die ID des Fensters, das den Absender enthält. Anders als beiTab##windowIdkann sie auch für Absender gesetzt sein, die sich nicht in einem Tab befinden, beispielsweise in einem Popup oder einer Seitenleiste. Sie fehlt, wenn der Absender kein Fenster hat, beispielsweise bei einer Hintergrundseite.
Browser-Kompatibilität
Hinweis:
Diese API basiert auf Chromiums API chrome.runtime. Diese Dokumentation wurde aus runtime.json im Chromium-Code abgeleitet.