runtime.MessageSender

Ein Objekt, das Informationen über den Absender einer Nachricht oder 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 Lebenszyklusstatus des Dokuments, das die Verbindung geöffnet hat, als der Port erstellt wurde. Beachten Sie, dass sich der Lebenszyklusstatus 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, wenn die Nachricht von einer Erweiterung gesendet wurde. Wenn der Absender eine ID ausdrücklich mit dem Schlüssel browser_specific_settings in manifest.json festgelegt hat, dann hat id diesen Wert. Andernfalls hat es die ID, die für den Absender generiert wurde.

origin Optional

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

tab Optional

tabs.Tab. Der tabs.Tab der die Verbindung geöffnet hat. Diese Eigenschaft ist nur vorhanden, wenn die Verbindung von einem Tab geöffnet wurde (einschließlich Inhaltsskripte).

tlsChannelId Optional

string. Die TLS-Kanal-ID der Seite oder des Frames, der 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 Hintergrundseite, eine Optionenseite oder ein Symbolleistenschaltflächen oder Seitenaktionspopup), 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 es "moz-extension://<extension-internal-id>/_generated_background_page.html".

Wenn der Absender ein Skript ist, das auf einer Webseite ausgeführt wird (einschließlich Inhalts- und normaler Seitenskripte), dann ist url die URL der Webseite. Wenn das Skript in einem iframe läuft, ist url die URL des iframes.

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
MessageSender
documentId
documentLifecycle
frameId
id
origin
tab
tlsChannelId
url

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Hinweis: Diese API basiert auf der chrome.runtime-API von Chromium. Diese Dokumentation stammt aus runtime.json im Chromium-Code.