CKTIS / JavaScript
messageerror — errore di deserializzazione di un messaggio del Worker
L’evento messageerror su un Worker segnala che non è stato possibile deserializzare un messaggio in arrivo. Distinguilo da un errore di invio in postMessage() e dall’evento error associato a un errore del worker.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
worker.addEventListener("messageerror", (event) => { /* handle receive failure */ });
worker.onmessageerror = (event) => { /* handle receive failure */ };L’evento messageerror event viene generato su un oggetto Worker quando non è possibile deserializzare un messaggio in arrivo dal worker, cioè ricostruirne il valore sul lato ricevente. Fa parte delle Web APIs, non di una specifica edizione di ECMAScript. L’evento è un MessageEvent, non propaga e non può essere annullato.
Registra un gestore con worker.addEventListener("messageerror", handler) oppure assegna una funzione a worker.onmessageerror. La prima forma consente più listener; la seconda imposta una singola proprietà di gestione. La direzione è importante: un listener su Worker gestisce la ricezione nel codice che ha creato il worker. All’interno di un worker dedicato, usa self.addEventListener("messageerror", handler) per gestire i messaggi ricevuti dal suo creatore.
Non confondere questo evento con ogni problema di comunicazione. Il tentativo di inviare un valore non clonabile può generare un DataCloneError sincrono da postMessage(); gestiscilo con try...catch sul mittente. L’evento error riguarda un errore del worker, non nello specifico la deserializzazione di un messaggio. messageerror non è nemmeno un meccanismo di convalida dei dati dell’applicazione: anche i messaggi ricevuti correttamente devono essere verificati.
L’esempio invia intenzionalmente un MessageEvent sintetico a un normale EventTarget. In questo modo mostra in modo deterministico l’attivazione del listener e i flag dell’evento, senza file worker. Non provoca un vero errore di deserializzazione né dimostra il supporto nativo dell’evento su Worker. MDN indica che la variante Worker ha disponibilità limitata: verifica la compatibilità con i browser di destinazione. La presenza di Node 24 in un repository non dimostra il supporto di questa API nei browser.
Esempi
(() => {
const target = new EventTarget();
target.addEventListener("messageerror", (event) => {
console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
});
target.dispatchEvent(new MessageEvent("messageerror"));
})();Risultato
messageerror: bubbles=false, cancelable=false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.