BroadcastChannel : évènement messageerror
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 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é.
addEventListener("messageerror", (event) => {});
onmessageerror = (event) => {};
Type de l'évènement
Un MessageEvent. Hérite de l'interface Event.
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.
dataLecture seule-
Les données envoyées par l'émetteur du message.
originLecture 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.
sourceLecture seule-
Un
MessageEventSource, qui peut être soit unWindowProxy, unMessagePort, ou un objetServiceWorkerreprésentant l'émetteur du message. portsLecture seule-
Un tableau d'objets
MessagePortrepré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 :
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 :
const canal = new BroadcastChannel("canal_exemple");
canal.onmessage = (event) => {
received.textContent = event.data;
};
canal.onmessageerror = (event) => {
console.log(event);
};
Spécifications
| Specification |
|---|
| HTML> # event-messageerror> |
| HTML> # handler-broadcastchannel-onmessageerror> |
Compatibilité des navigateurs
Chargement…
Voir aussi
- Évènements liés :
message.