BroadcastChannel : évènement messageerror

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'é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 Lecture seule

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

origin Lecture seule

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

lastEventIdLecture seule

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

source Lecture seule

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

ports Lecture seule

Un tableau d'objets MessagePort 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