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

CKTIS / JavaScript

messageerror — fallo de deserialización de un mensaje de Worker

El evento messageerror en un Worker indica que no se pudo deserializar un mensaje entrante. Distínguelo de un fallo de envío en postMessage() y del evento error asociado a un error del 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.addEventListener("messageerror", (event) => { /* handle receive failure */ });
worker.onmessageerror = (event) => { /* handle receive failure */ };

El messageerror event se dispara en un objeto Worker cuando un mensaje entrante procedente del worker no se puede deserializar; es decir, no se puede reconstruir su valor en el lado receptor. Forma parte de las Web APIs, no de una edición concreta de ECMAScript. El evento es un MessageEvent, no burbujea y no se puede cancelar.

Registra un controlador con worker.addEventListener("messageerror", handler) o asigna una función a worker.onmessageerror. La primera forma permite varios escuchadores; la segunda establece una única propiedad de controlador. La dirección importa: un escuchador en Worker gestiona la recepción en el código que creó el worker. Dentro de un worker dedicado, usa self.addEventListener("messageerror", handler) para gestionar la recepción desde quien lo creó.

No confundas este evento con cualquier problema de comunicación. Intentar enviar un valor que no se puede clonar puede lanzar un DataCloneError síncrono desde postMessage(); gestiónalo con try...catch en el emisor. El evento error se refiere a un error del worker, no específicamente a la deserialización de mensajes. messageerror tampoco sirve para validar los datos de la aplicación: los mensajes recibidos correctamente también deben validarse.

El ejemplo envía deliberadamente un MessageEvent sintético a un EventTarget normal. Así demuestra de forma determinista la invocación del escuchador y las propiedades del evento, sin archivos de worker. No provoca un fallo real de deserialización ni demuestra la compatibilidad nativa del evento en Worker. MDN indica que la variante Worker tiene disponibilidad limitada: comprueba la compatibilidad con los navegadores de destino. Que Node 24 esté en un repositorio no demuestra que los navegadores admitan esta API.

Ejemplos

(() => {
  const target = new EventTarget();
  target.addEventListener("messageerror", (event) => {
    console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
  });
  target.dispatchEvent(new MessageEvent("messageerror"));
})();

Resultado

messageerror: bubbles=false, cancelable=false

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