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.
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