BroadcastChannel

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.

Das BroadcastChannel-Interface repräsentiert einen benannten Kanal, auf den jeder Browsing-Kontext eines bestimmten Ursprungs zugreifen kann. Es ermöglicht die Kommunikation zwischen verschiedenen Dokumenten (in unterschiedlichen Fenstern, Tabs, Frames oder iframes) desselben Ursprungs. Nachrichten werden über ein message-Ereignis gesendet, das bei allen BroadcastChannel-Objekten ausgelöst wird, die den Kanal abhören, mit Ausnahme des Objekts, das die Nachricht gesendet hat.

EventTarget BroadcastChannel

Konstruktor

BroadcastChannel()

Erstellt ein Objekt, das mit dem benannten Kanal verknüpft ist.

Instanz-Eigenschaften

Dieses Interface erbt auch Eigenschaften von seinem übergeordneten Interface, EventTarget.

BroadcastChannel.name Schreibgeschützt

Gibt einen String zurück, den Namen des Kanals.

Instanz-Methoden

Dieses Interface erbt auch Methoden von seinem übergeordneten Interface, EventTarget.

BroadcastChannel.postMessage()

Sendet die Nachricht, unabhängig vom Objekttyp, an jedes BroadcastChannel-Objekt, das denselben Kanal abhört.

BroadcastChannel.close()

Schließt das Kanalobjekt, zeigt an, dass es keine neuen Nachrichten mehr erhalten wird, und ermöglicht es, schließlich vom Garbage Collector bereinigt zu werden.

Ereignisse

Dieses Interface erbt auch Ereignisse von seinem übergeordneten Interface, EventTarget.

message

Wird ausgelöst, wenn eine Nachricht auf dem Kanal eintrifft. Auch über die onmessage-Eigenschaft verfügbar.

messageerror

Wird ausgelöst, wenn eine Nachricht eintrifft, die nicht deserialisiert werden kann. Auch über die onmessageerror-Eigenschaft verfügbar.

Spezifikationen

Specification
HTML Standard
# broadcasting-to-other-browsing-contexts

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch