CKTIS / JavaScript
messageerror — deserialisatiefout bij een Worker-bericht
De messageerror-gebeurtenis op een Worker geeft aan dat een binnenkomend bericht niet kon worden gedeserialiseerd. Onderscheid deze gebeurtenis van een verzendfout in postMessage() en van de error-gebeurtenis die bij een workerfout hoort.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
worker.addEventListener("messageerror", (event) => { /* handle receive failure */ });
worker.onmessageerror = (event) => { /* handle receive failure */ };Het messageerror event wordt geactiveerd op een Worker-object wanneer een binnenkomend bericht van de worker niet kan worden gedeserialiseerd: de waarde kan dan niet aan de ontvangende kant worden hersteld. Het hoort bij de Web APIs, niet bij een specifieke ECMAScript-editie. Het is een MessageEvent, bubbelt niet en kan niet worden geannuleerd.
Registreer een handler met worker.addEventListener("messageerror", handler) of wijs een functie toe aan worker.onmessageerror. Met de eerste vorm kun je meerdere listeners toevoegen; de tweede stelt één handler-eigenschap in. De richting is belangrijk: een listener op Worker behandelt de ontvangst in de code die de worker heeft gemaakt. Gebruik binnen een dedicated worker self.addEventListener("messageerror", handler) om berichten van de maker te behandelen.
Verwar deze gebeurtenis niet met elk communicatieprobleem. Een poging om een niet-kloonbare waarde te verzenden kan vanuit postMessage() synchroon een DataCloneError veroorzaken — vang die bij de verzender af met try...catch. De error-gebeurtenis gaat over een workerfout, niet specifiek over het deserialiseren van een bericht. messageerror is ook geen validatie van toepassingsgegevens; een correct ontvangen bericht moet nog steeds worden gecontroleerd.
Het voorbeeld verstuurt bewust een synthetische MessageEvent naar een gewone EventTarget. Zo laat het deterministisch zien dat de listener wordt aangeroepen en welke gebeurtenisvlaggen gelden, zonder workerbestanden. Het veroorzaakt geen echte deserialisatiefout en toont geen native ondersteuning voor de gebeurtenis op Worker aan. MDN vermeldt beperkte beschikbaarheid voor de Worker-variant: controleer de compatibiliteit van je doelbrowsers. Dat Node 24 in een repository aanwezig is, bewijst geen browserondersteuning voor deze API.
Voorbeelden
(() => {
const target = new EventTarget();
target.addEventListener("messageerror", (event) => {
console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
});
target.dispatchEvent(new MessageEvent("messageerror"));
})();Resultaat
messageerror: bubbles=false, cancelable=false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.