CKTIS / JavaScript
messageerror — échec de désérialisation d’un message de Worker
L’événement messageerror sur un Worker signale qu’un message entrant n’a pas pu être désérialisé. Distinguez-le d’un échec d’envoi dans postMessage() et de l’événement error associé à une erreur du Worker.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
worker.addEventListener("messageerror", (event) => { /* handle receive failure */ });
worker.onmessageerror = (event) => { /* handle receive failure */ };L’événement messageerror event est déclenché sur un objet Worker lorsqu’un message entrant provenant du worker ne peut pas être désérialisé, c’est-à-dire que sa valeur ne peut pas être reconstruite côté réception. Il fait partie des Web APIs, et non d’une édition particulière d’ECMAScript. Cet événement est un MessageEvent ; il ne remonte pas dans l’arbre et ne peut pas être annulé.
Enregistrez un gestionnaire avec worker.addEventListener("messageerror", handler) ou affectez une fonction à worker.onmessageerror. La première forme permet plusieurs écouteurs ; la seconde définit une propriété de gestionnaire unique. Le sens de réception compte : un écouteur sur Worker gère la réception dans le code qui a créé le worker. Dans un worker dédié, utilisez self.addEventListener("messageerror", handler) pour gérer les messages reçus de son créateur.
Ne confondez pas cet événement avec tout problème de communication. Tenter d’envoyer une valeur qui ne peut pas être clonée peut provoquer une exception synchrone DataCloneError dans postMessage() — gérez-la avec try...catch chez l’expéditeur. L’événement error concerne une erreur du worker, et non spécifiquement la désérialisation d’un message. messageerror ne valide pas non plus les données de l’application ; un message reçu correctement doit toujours être vérifié.
L’exemple distribue volontairement un MessageEvent synthétique sur un simple EventTarget. Il montre ainsi de façon déterministe l’appel de l’écouteur et les indicateurs de l’événement, sans fichiers de worker. Il ne provoque pas de véritable échec de désérialisation et ne démontre pas la prise en charge native de l’événement sur Worker. MDN indique que la variante Worker a une disponibilité limitée : vérifiez la compatibilité des navigateurs ciblés. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge de cette API dans les navigateurs.
Exemples
(() => {
const target = new EventTarget();
target.addEventListener("messageerror", (event) => {
console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
});
target.dispatchEvent(new MessageEvent("messageerror"));
})();Résultat
messageerror: bubbles=false, cancelable=false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.