Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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:

Typ

Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:

documentId Optional

string. Eine UUID des Dokuments, das die Verbindung geöffnet hat. Weitere Informationen finden Sie im Artikel Mit documentId arbeiten.

documentLifecycle Optional

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.

frameId Optional

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, wenn tab gesetzt ist.

id Optional

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, hat id diesen Wert. Andernfalls enthält die Eigenschaft die für den Absender generierte ID.

origin Optional

string. Der Ursprung der Seite oder des Frames, die bzw. der die Verbindung geöffnet hat. Er kann von der Eigenschaft url abweichen (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.

tab Optional

tabs.Tab. Das tabs.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).

tlsChannelId Optional

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.

url Optional

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 url die URL der Webseite. Wird das Skript in einem iframe ausgeführt, ist url die URL des iframes.

userScriptWorldId Optional

string. Die worldId der USER_SCRIPT-Welt, die die Nachricht gesendet hat. Nur in runtime.onUserScriptMessage und in port.sender für runtime.onUserScriptConnect vorhanden.

windowId Optional

integer. Die ID des Fensters, das den Absender enthält. Anders als bei Tab##windowId kann 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.