Un client rejoint un canal de diffusion en créant un objetBroadcastChannel. Sonconstructeur prend un unique paramètre : lenom du canal. S'il est le premier à se connecter à ce nom de canal de diffusion, alors le canal sous-jacent est créé.

// Connexion au canal de diffusionconst bc = new BroadcastChannel("canal_test");

Il suffit d'appeler la méthodepostMessage() sur l'objetBroadcastChannel créé, qui prend n'importe quel objet comme argument. Un exemple de message :

// Exemple d'envoi d'un message très simplebc.postMessage("Ceci est un message test.");

Les données envoyées sur le canal sont sérialisées via l'algorithme de clonage de structure. Ceci implique que vous pouvez envoyer un large spectre de type de données de manière sure sans avoir à les sérialiser par vous-même.

Cette API n'associe aucune sémantique particulière aux messages, c'est donc au code de savoir à quelle sorte de message s'attendre et quel usage il peut en tirer.

Lorsqu'un message est posté, un évènementmessage est distribué sur chaque objetBroadcastChannel connecté à ce canal. Une fonction peut être exécutée pour le traitement de cet évènement en utilisant le gestionnaire d'évènementsonmessage :

// Un gestionnaire affichant simplement les messages sur la console :bc.onmessage = (event) => {  console.log(event);};

Pour quitter un canal, appelez la méthodeclose() de l'objet. Cet appel déconnectera l'objet du canal sous-jacent permettant au ramasse-miettes de s'exécuter.

// Déconnexion du canalbc.close();

L'interface intégrée de l'APIBroadcast Channel permet une communication inter-contexte. Il peut être utilisé pour détecter des actions utilisateurs dans d'autre onglets d'une même origine, telle qu'une connexion ou déconnexion d'utilisateur du site.

Le protocole ne définit pas le contenu des messages ni leurs significations. Il sera à la charge de la développeuse ou du développeur d'implanter leur propre jeu de messages et traitements associés.

BroadcastChannel, l'interface qui porte cette API.