runtime.MessageSender
Ein Objekt, das Informationen über den Absender einer Nachricht oder eine 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 Lebenszyklusstatus des Dokuments, das die Verbindung öffnete, 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 öffnete. Null für Frames auf oberster Ebene, positiv für untergeordnete Frames. Dies wird nur festgelegt, wenntab
festgelegt 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 Schlüssel browser_specific_settings in der manifest.json festgelegt hat, dann hatid
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 öffnete. Dieser kann sich von derurl
-Eigenschaft unterscheiden (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 aus der URL ersichtlich ist. tab
Optional-
tabs.Tab
. Dietabs.Tab
, die die Verbindung geöffnet hat. Diese Eigenschaft ist nur vorhanden, wenn die Verbindung von einem Tab (einschließlich Inhalts-Skripten) geöffnet wurde. 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, in dem das Skript läuft, welches die Nachricht gesendet hat.Wenn der Absender ein Skript ist, das in einer Erweiterungsseite läuft (wie eine Hintergrundseite, eine Optionsseite oder ein 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 eingebunden haben, ist die URL"moz-extension://<extension-internal-id>/_generated_background_page.html"
.Wenn der Absender ein Skript ist, das in einer Webseite läuft (einschließlich Inhalts- und normaler Seitenskripte), dann ist die
url
die URL der Webseite. Falls das Skript in einem Iframe läuft, isturl
die URL des Iframes. userScriptWorldId
Optional-
string
. DieworldId
derUSER_SCRIPT
-Welt, die die Nachricht gesendet hat. Nur vorhanden inruntime.onUserScriptMessage
und inport.sender
fürruntime.onUserScriptConnect
.
Browser-Kompatibilität
BCD tables only load in the browser
Hinweis:
Diese API basiert auf Chromiums chrome.runtime
API. Diese Dokumentation ist abgeleitet von runtime.json
im Chromium-Code.