Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Eventos de Worker: mensajes y errores

Worker.onmessage recibe las respuestas del worker, Worker.onerror informa de los fallos del worker y Worker.onmessageerror gestiona la deserialización fallida de un mensaje entrante. Estos tres controladores pertenecen al objeto Worker del código que creó el worker.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

worker.onmessage = (event) => { /* event.data */ };
worker.onerror = (event) => { /* worker failure */ };
worker.onmessageerror = (event) => { /* deserialization failure */ };

Worker.onmessage, Worker.onerror y Worker.onmessageerror son propiedades que se asignan a una instancia, como worker.onmessage. Gestionan, respectivamente, los eventos message, error y messageerror en el lado que creó un worker dedicado. Son API web especificadas por HTML, no características de una edición concreta de ECMAScript.

Worker.onmessage recibe un MessageEvent; el valor transmitido está en event.data. Al llamar a worker.postMessage(value) se envían datos al worker, mientras que self.postMessage(value) dentro del worker envía una respuesta. En cambio, Worker.onerror recibe un argumento de evento que informa de un fallo del worker. No lo confundas con self.onerror dentro del worker, que tiene una firma histórica con varios argumentos.

Worker.onmessageerror recibe un MessageEvent cuando no se puede deserializar un mensaje entrante. No es un controlador general de errores de cálculo ni sustituye la gestión de excepciones en el lado emisor. Los datos que se pasan a postMessage() deben ser compatibles con el algoritmo de clonación estructurada. Ni message ni messageerror se propagan hacia arriba ni se pueden cancelar.

Las alternativas son addEventListener("message", handler), addEventListener("error", handler) y addEventListener("messageerror", handler). MDN indica que message y error están ampliamente disponibles, pero que messageerror tiene disponibilidad limitada; comprueba los navegadores de destino. Que Node 24 esté presente en un repositorio no demuestra que estas API sean compatibles con los navegadores.

Ejemplos

(() => {
  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;
  }
})();

Resultado

result: 42

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes