Window : évènement messageerror

Baseline Large disponibilité

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.

Dans cet article

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.

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

onmessageerror = (event) => { }

Type d'évènement

Un objet MessageEvent. Hérite de Event.

Event MessageEvent

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

Cette interface hérite également des propriétés de son parent, Event.

MessageEvent.data Lecture seule

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

MessageEvent.origin Lecture seule

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

MessageEvent.lastEventId Lecture seule

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

MessageEvent.source Lecture seule

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

MessageEvent.ports Lecture seule

Un tableau d'objets MessagePort repré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() :

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

Idem, mais en utilisant la propriété de gestionnaire d'évènements onmessageerror :

js
window.onmessageerror = (event) => {
  console.error(event);
};

Spécifications

Spécification

HTML
# event-messageerror

HTML
# handler-window-onmessageerror

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Voir aussi

La méthode Window.postMessage()
Évènements associés : message.

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 16 mars 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu