Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Eventi Worker: messaggi ed errori

Worker.onmessage riceve le risposte del worker, Worker.onerror segnala i guasti del worker e Worker.onmessageerror gestisce la deserializzazione non riuscita di un messaggio in arrivo. Questi tre gestori appartengono all’oggetto Worker nel codice che ha creato il 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.onmessage = (event) => { /* event.data */ };
worker.onerror = (event) => { /* worker failure */ };
worker.onmessageerror = (event) => { /* deserialization failure */ };

Worker.onmessage, Worker.onerror e Worker.onmessageerror sono proprietà assegnate a un’istanza, per esempio worker.onmessage. Gestiscono rispettivamente gli eventi message, error e messageerror sul lato che ha creato un worker dedicato. Sono API Web specificate da HTML, non funzionalità di una particolare edizione di ECMAScript.

Worker.onmessage riceve un MessageEvent; il valore trasmesso si trova in event.data. Chiamare worker.postMessage(value) invia dati al worker, mentre self.postMessage(value) all’interno del worker invia una risposta. Worker.onerror, invece, riceve un argomento evento che segnala un guasto del worker. Non confonderlo con self.onerror all’interno del worker, che ha una firma storica con più argomenti.

Worker.onmessageerror riceve un MessageEvent quando un messaggio in arrivo non può essere deserializzato. Non è un gestore generico degli errori di calcolo né un sostituto della gestione delle eccezioni sul lato mittente. I dati passati a postMessage() devono essere supportati dall’algoritmo di structured clone. Né message né messageerror risalgono la propagazione o possono essere annullati.

Le alternative sono addEventListener("message", handler), addEventListener("error", handler) e addEventListener("messageerror", handler). MDN indica message ed error come ampiamente disponibili, ma messageerror come a disponibilità limitata; controlla i browser di destinazione. La presenza di Node 24 in un repository non dimostra il supporto di queste API nei browser.

Esempi

(() => {
  const source = 'self.onmessage = (event) => { self.postMessage(event.data * 2); };';
  const url = URL.createObjectURL(new Blob([source], { type: 'text/javascript' }));
  let worker;
  const cleanup = () => {
    worker?.terminate();
    URL.revokeObjectURL(url);
  };

  try {
    worker = new Worker(url);
    worker.onmessage = (event) => {
      console.log(`result: ${event.data}`);
      cleanup();
    };
    worker.onerror = () => {
      console.error('worker error');
      cleanup();
    };
    worker.onmessageerror = () => {
      console.error('message deserialization error');
      cleanup();
    };
    worker.postMessage(21);
  } catch (error) {
    cleanup();
    throw error;
  }
})();

Risultato

result: 42

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