runtime.MessageSender

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 Rahmen, der die Verbindung geöffnet hat. Null für Top-Level-Rahmen, positiv für untergeordnete Rahmen. 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 ausdrücklich mithilfe des browser_specific_settings-Schlüssels in manifest.json gesetzt 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 Rahmens, der die Verbindung geöffnet hat. Er kann sich von der url-Eigenschaft unterscheiden (z. B. about:blank) oder undurchsichtig sein (z. B. wennrames). Dies ist nützlich, um zu erkennen, ob dem Ursprung vertraut werden kann, wenn 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 Content-Skripten).

tlsChannelId Optional

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

url Optional

string. Die URL der Seite oder des Rahmens, der das Skript hostet, das die Nachricht gesendet hat.

Wenn der Absender ein Skript ist, das in 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 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 Content- und normaler Seitenskripte), 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.