BroadcastChannel

Baseline 2022

Newly available

Since March 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

L'interface BroadcastChannel représente un canal nommé auquel peut s'abonner n'importe quel contexte de navigation d'une même origine. Il permet la communication entre différents documents (dans différentes fenêtres, onglets, cadres ou iframes) d'une même origine. Les messages sont diffusés via un évènement message déclenché à tout objet BroadcastChannel écoutant le canal, sauf celui qui l'a envoyé.

Note: Cette fonctionnalité est disponible via les Web Workers.

Constructeur

BroadcastChannel(): Crée un objet lié au canal nommé.

Propriétés

Cette interface hérite aussi des propriétés de son parent, EventTarget.

BroadcastChannel.name Lecture seule: Retourne une chaîne, le nom du canal.

Méthodes

Cette interface hérite aussi des méthodes de son parent, EventTarget.

BroadcastChannel.postMessage(): Envoie un message de n'importe quel type d'objet à l'objet BroadcastChannel écoutant sur le même canal.
BroadcastChannel.close(): Ferme l'objet canal, indiquant qu'il n'aura plus aucun nouveau message et lui permettant finalement d'être libéré par le ramasse-miettes.

Évènements

message: Déclenché lorsqu'un message arrive sur le canal. Également accessible via la propriété onmessage.
messageerror: Déclenché lorsqu'un message arrive mais ne peut pas être désérialisé. Également accessible via la propriété onmessageerror.

Spécifications

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

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

Un autre moyen, plus fourni, de communiquer entre contextes navigateurs : ServiceWorker.
Vue d'ensemble de l'API Broadcast Channel