BroadcastChannel: postMessage() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2022.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die postMessage()
-Methode der BroadcastChannel
-Schnittstelle sendet eine Nachricht,
die jeglicher Art von Object
sein kann,
an jeden Listener in jedem Browsing-Kontext mit dem gleichen Origin.
Die Nachricht wird als message
-Ereignis
an jeden mit dem Kanal verbundenen BroadcastChannel
gesendet.
Syntax
postMessage(message)
Parameter
message
-
Daten, die an das andere Fenster gesendet werden sollen. Die Daten werden mit dem structured clone algorithm serialisiert. Das bedeutet, dass Sie eine große Vielzahl von Datenobjekten sicher an das Ziel-Fenster übergeben können, ohne sie selbst serialisieren zu müssen.
Rückgabewert
Keiner.
Ausnahmen
InvalidStateError
DOMException
-
Wird ausgelöst, wenn der
BroadcastChannel
bereits geschlossen wurde. DataCloneError
DOMException
-
Wird ausgelöst, wenn ein Teil der Eingabedaten nicht serialisierbar ist.
Spezifikationen
Specification |
---|
HTML Standard # dom-broadcastchannel-postmessage-dev |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
BroadcastChannel
, die Schnittstelle, zu der sie gehört.