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: Dieses Feature ist verfügbar in Web Workers.

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

js
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