BroadcastChannel: Methode postMessage()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨März 2022⁩.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die postMessage()-Methode des BroadcastChannel-Interfaces sendet eine Nachricht, die jede Art von Object sein kann, an jeden Listener in jedem Browsing-Kontext mit dem gleichen Ursprung. Die Nachricht wird als message-Ereignis an jedes mit dem Kanal verbundene BroadcastChannel gesendet.

Syntax

postMessage(message)

message: Daten, die an das andere Fenster gesendet werden sollen. Die Daten werden mit dem strukturierter Klonalgorithmus serialisiert. Das bedeutet, dass Sie eine Vielzahl von Datenobjekten sicher an das Ziel-Fenster übergeben können, ohne sie selbst serialisieren zu müssen.

Hinweis: Ausführungskontexte, die miteinander kommunizieren können, befinden sich möglicherweise nicht im selben Agent-Cluster und können daher keinen Speicher teilen. SharedArrayBuffer-Objekte oder darauf basierende Pufferansichten können nicht über Agent-Cluster hinweg gesendet werden. Der Versuch, dies zu tun, erzeugt ein messageerror-Ereignis, das einen DataCloneError-DOMException am empfangenden Ende enthält.

Keiner.

InvalidStateError DOMException: Wird ausgelöst, wenn der BroadcastChannel bereits geschlossen wurde.
DataCloneError DOMException: Wird ausgelöst, wenn ein Teil der Eingabedaten nicht serialisierbar ist.

Specification
HTML # dom-broadcastchannel-postmessage-dev

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.