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é.
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.
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.
lastEventId
Lecture seule-
Une chaîne représentant l'identifiant unique pour l'évènement.
source
Lecture seule-
Un
MessageEventSource
, qui peut être soit unWindowProxy
, unMessagePort
, ou un objetServiceWorker
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 :
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 Standard # event-messageerror |
HTML Standard # handler-broadcastchannel-onmessageerror |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
- Évènements liés :
message
.