Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti