BroadcastChannel : évènement messageerror

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'évènement messageerror est déclenché sur un objet BroadcastChannel lorsqu'un message qui n'a pas pu être désérialisé arrive dans le canal.

Syntaxe

Utilisez le nom de l'évènement dans les méthodes telles que addEventListener(), ou définissez un gestionnaire d'évènements dans la propriété.

js
addEventListener("messageerror", (event) => {});
onmessageerror = (event) => {};

Type de l'évènement

Un MessageEvent. Hérite de l'interface Event.

Event MessageEvent

Propriétés de l'évènement

En plus des propriétés listées ci-dessous, les propriétés de l'interface parente Event sont accessibles.

data (en-US) Lecture seule

Les données envoyées par l'émetteur du message.

origin (en-US) Lecture seule

Une chaîne représentant l'origine de l'émetteur du message.

lastEventId (en-US)Lecture seule

Une chaîne représentant l'identifiant unique pour l'évènement.

source (en-US) Lecture seule

Un MessageEventSource, qui peut être soit un WindowProxy (en-US), un MessagePort (en-US), ou un objet ServiceWorker représentant l'émetteur du message.

ports (en-US) Lecture seule

Un tableau d'objets MessagePort (en-US) représentant les ports associés au canal par lequel le message est envoyé (lorsque c'est approprié, par exemple, dans le canal de communication ou lorsqu'un message est envoyé à un worker partagé).

Exemples

Ce code utilise addEventListener pour écouter les messages et les erreurs :

js
const canal = new BroadcastChannel("canal_exemple");

canal.addEventListener("message", (event) => {
  received.textContent = event.data;
});

canal.addEventListener("messageerror", (event) => {
  console.error(event);
});

Voici un exemple similaire qui utilise les gestionnaires d'évènements onmessage et onmessageerror :

js
const canal = new BroadcastChannel("canal_exemple");

canal.onmessage = (event) => {
  received.textContent = event.data;
};

canal.onmessageerror = (event) => {
  console.log(event);
};

Spécifications

Specification
HTML Standard
# event-messageerror
HTML Standard
# handler-broadcastchannel-onmessageerror

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi