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

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
# dom-broadcastchannel-postmessage-dev

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
postMessage

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
User must explicitly enable this feature.

Siehe auch