Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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.

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

Specification
HTML
# event-messageerror
HTML
# handler-window-onmessageerror

Compatibilité des navigateurs

Voir aussi