runtime.MessageSender

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, 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 über den Schlüssel browser_specific_settings in der manifest.json gesetzt hat, dann hat id diesen Wert. Andernfalls erhält es die für den Absender generierte ID.

origin Optional

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

tab Optional

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

tlsChannelId Optional

string. Die TLS-Kanal-ID der Seite oder des Frames, der die Verbindung geöffnet hat, wenn dies von der Erweiterung angefordert und verfügbar ist.

url Optional

string. Die URL der Seite oder des Frames, die das Skript beherbergt, das die Nachricht gesendet hat.

Wenn der Absender ein Skript ist, das auf einer Erweiterungsseite ausgeführt wird (wie eine Hintergrundseite, eine Optionsseite oder ein Browser-Action oder Page-Action Popup), hat die URL die Form "moz-extension://<extension-internal-id>/path/to/page.html". Wenn der Absender ein Hintergrund-Skript 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 ausgeführt wird (einschließlich Inhalts- und normaler 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 vorhanden in runtime.onUserScriptMessage und in port.sender für runtime.onUserScriptConnect.

Browser-Kompatibilität