Window : é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 2023.
L'évènement messageerror est déclenché sur un objet Window lorsqu'il reçoit un message qui ne peut pas être désérialisé.
Cet évènement n'est pas annulable et ne se propage pas.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'événements.
addEventListener("messageerror", (event) => { })
onmessageerror = (event) => { }
Type d'évènement
Un objet MessageEvent. Hérite de Event.
Propriétés de l'évènement
Cette interface hérite également des propriétés de son parent, Event.
MessageEvent.dataLecture seule-
Les données envoyées par l'émetteur du message.
MessageEvent.originLecture seule-
Une chaîne de caractères représentant l'origine de l'émetteur du message.
MessageEvent.lastEventIdLecture seule-
Une chaîne de caractères représentant un identifiant unique pour l'évènement.
MessageEvent.sourceLecture seule-
Un objet
MessageEventSource(qui peut être un WindowProxy,MessagePort, ouServiceWorker) représentant l'émetteur du message. MessageEvent.portsLecture seule-
Un tableau d'objets
MessagePortreprésentant les ports associés au canal par lequel le message est envoyé (le cas échéant, par exemple, dans la messagerie de canal ou lors de l'envoi d'un message à un worker partagé).
Exemples
Écoutez messageerror en utilisant addEventListener() :
window.addEventListener("messageerror", (event) => {
console.error(event);
});
Idem, mais en utilisant la propriété de gestionnaire d'évènements onmessageerror :
window.onmessageerror = (event) => {
console.error(event);
};
Spécifications
| Specification |
|---|
| HTML> # event-messageerror> |
| HTML> # handler-window-onmessageerror> |
Compatibilité des navigateurs
Voir aussi
- La méthode
Window.postMessage() - Évènements associés :
message.