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 in 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 seit der Erstellung des Ports geändert haben kann.

frameId Optional

integer. Der Frame, der die Verbindung geöffnet hat. Null für oberste Frames, positiv für untergeordnete Frames. Dies wird nur gesetzt, wenn tab 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 mit dem browser_specific_settings Schlüssel in manifest.json gesetzt hat, dann hat id diesen Wert. Andernfalls hat es die für den Absender generierte ID.

origin Optional

string. Der Ursprung der Seite oder des Frames, der die Verbindung geöffnet hat. Dies kann sich von der url-Eigenschaft unterscheiden (z.B. about:blank) oder undurchsichtig sein (z.B. sandboxed iframes). Dies ist nützlich zur Identifizierung, ob der Ursprung vertrauenswürdig ist, wenn dies aus der URL nicht ersichtlich ist.

tab Optional

tabs.Tab. Der tabs.Tab welcher die Verbindung geöffnet hat. Diese Eigenschaft ist nur vorhanden, wenn die Verbindung von einem Tab (inklusive Inhalts-Skripten) 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 auf einer Erweiterungsseite ausgeführt wird (wie eine background page, eine options page, oder einem browser action oder page action Popup), dann hat die URL die Form "moz-extension://<extension-internal-id>/path/to/page.html". Wenn der Absender ein Hintergrundskript ist und Sie keine Hintergrundseite einbezogen haben, lautet sie "moz-extension://<extension-internal-id>/_generated_background_page.html".

Wenn der Absender ein Skript ist, das in einer Webseite ausgeführt wird (einschließlich Content- und normalen Seitenskripten), dann ist url die URL der Webseite. Wenn das Skript in einem iframe ausgeführt wird, 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.

Browser-Kompatibilität

Hinweis: Diese API basiert auf Chromiums chrome.runtime API. Diese Dokumentation ist abgeleitet von runtime.json im Chromium-Code.