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

CKTIS / JavaScript

Worker.postMessage — enviar datos a un worker

Worker.postMessage envía datos a un worker dedicado mediante un canal de mensajes asíncrono. Los datos se clonan estructuralmente; una lista de transferencia opcional permite transferir recursos como ArrayBuffer en lugar de copiarlos.

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.postMessage(message)
worker.postMessage(message, transfer)
worker.postMessage(message, { transfer })

Worker.postMessage se refiere a un método de instancia de Worker, no a un método estático del constructor. La llamada worker.postMessage(message) envía datos a un worker dedicado. Que la llamada termine sin errores no garantiza la entrega: el worker puede finalizar antes de que se dispare el evento. Si falla la deserialización en el lado receptor, se produce un evento messageerror en lugar de message. Cuando el receptor recibe un evento message, lee los datos en event.data. El método devuelve undefined, no una Promise; que la llamada termine no significa que el receptor haya acabado su trabajo.

El mensaje se clona estructuralmente, no se serializa mediante JSON. Se admiten, entre otros valores, objetos simples y matrices; las funciones no se admiten y provocan una excepción síncrona DataCloneError. No des por hecho que se conservarán los prototipos de las clases personalizadas. La entrega es asíncrona, pero la serialización se realiza durante la llamada y puede suponer trabajo para quien envía.

El segundo argumento, que es opcional, es una lista transfer o un objeto { transfer }. Transferir un ArrayBuffer separa el búfer del emisor: su byteLength pasa a ser 0. El búfer también debe ser accesible desde message para que el receptor pueda usarlo; la lista de transferencia por sí sola no lo añade a los datos del mensaje. Transfiere el búfer de una matriz tipada, no la propia matriz tipada como elemento de la lista de transferencia.

Envía una respuesta dentro del worker mediante self.postMessage(...) y recíbela en el objeto worker. Esto no es window.postMessage: no hay ningún argumento targetOrigin. SharedWorker utiliza worker.port.postMessage(...). Esta API está definida por HTML Living Standard, no por una edición de ECMAScript. El método básico está disponible en los motores de navegador modernos; comprueba por separado la compatibilidad de la forma de transferencia que utilices. Node 24 no acredita que esta API de navegador esté disponible.

Ejemplos

const source = `
self.onmessage = ({ data }) => {
  const values = new Uint8Array(data);
  self.postMessage(values[0] + values[1]);
};
`;
const url = URL.createObjectURL(new Blob([source], {
  type: 'text/javascript'
}));
const worker = new Worker(url);
const cleanup = () => {
  worker.terminate();
  URL.revokeObjectURL(url);
};
worker.onmessage = ({ data }) => {
  console.log('sum:', data);
  cleanup();
};
worker.onerror = () => {
  console.error('Worker failed');
  cleanup();
};
worker.onmessageerror = () => {
  console.error('Message decoding failed');
  cleanup();
};
const buffer = new Uint8Array([20, 22]).buffer;
worker.postMessage(buffer, [buffer]);
console.log('sender bytes:', buffer.byteLength);

Resultado

sender bytes: 0
sum: 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