CKTIS / JavaScript
DedicatedWorkerGlobalScope.postMessage() — enviar mensajes desde un worker
DedicatedWorkerGlobalScope.postMessage envía datos desde un worker dedicado a quien lo creó. El destinatario los lee mediante event.data. El método admite la clonación estructurada y la transferencia opcional de la propiedad de objetos.
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
self.postMessage(message)
self.postMessage(message, transfer)
self.postMessage(message, { transfer })DedicatedWorkerGlobalScope.postMessage es un método de la API web disponible dentro de un worker dedicado como self.postMessage(). Envía un mensaje a quien creó el worker. El destinatario gestiona el evento message en el objeto Worker y lee event.data. Para la dirección opuesta se usa Worker.postMessage().
El argumento message contiene un único valor; puedes agrupar varios elementos en un objeto o una matriz. La clonación estructurada también admite referencias circulares. La matriz opcional transfer, proporcionada directamente o como { transfer }, transfiere la propiedad de los objetos compatibles en lugar de copiarlos. Después, ya no se pueden usar en el lado emisor. La lista por sí sola no añade objetos al mensaje: deben estar incluidos en él o ser accesibles para el destinatario por otra vía.
El método devuelve undefined, no la respuesta del destinatario. Es una API del navegador, no una característica de ECMAScript; MDN la marca como ampliamente disponible. El ejemplo crea un worker dedicado, envía 21 y muestra la respuesta 42.
Ejemplos
const source = `
self.onmessage = (event) => {
self.postMessage(event.data * 2);
};
`;
const url = URL.createObjectURL(
new Blob([source], { type: "text/javascript" })
);
const worker = new Worker(url);
worker.onmessage = (event) => {
console.log(event.data);
worker.terminate();
URL.revokeObjectURL(url);
};
worker.onerror = () => {
worker.terminate();
URL.revokeObjectURL(url);
console.error("Worker failed");
};
worker.postMessage(21);Resultado
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.