CKTIS / JavaScript
Worker.postMessage — enviar dados para um worker
Worker.postMessage envia dados para um worker dedicado através de um canal de mensagens assíncrono. Os dados são clonados estruturalmente; uma lista de transferência opcional permite transferir recursos como ArrayBuffer em vez de os copiar.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
worker.postMessage(message)
worker.postMessage(message, transfer)
worker.postMessage(message, { transfer })Worker.postMessage designa um método de instância de Worker, não um método estático do construtor. A chamada worker.postMessage(message) envia dados para um worker dedicado. Uma chamada bem-sucedida não garante a entrega: o worker pode terminar antes de o evento ser disparado. Se a desserialização falhar do lado do destinatário, este recebe um evento messageerror em vez de message. Quando recebe um evento message, o destinatário lê os dados em event.data. O método devolve undefined, não uma Promise; o fim da chamada não significa que o destinatário tenha terminado o seu trabalho.
A mensagem é clonada estruturalmente, não serializada através de JSON. São suportados, entre outros valores, objetos simples e arrays; as funções não são suportadas e causam uma exceção síncrona DataCloneError. Não parta do princípio de que os protótipos de classes personalizadas são preservados. A entrega é assíncrona, mas a serialização ocorre durante a chamada e pode exigir trabalho do emissor.
O segundo argumento, opcional, é uma lista transfer ou um objeto { transfer }. Transferir um ArrayBuffer separa o buffer do emissor: o seu byteLength passa a ser 0. O buffer também tem de estar acessível a partir de message para que o destinatário o possa usar; a lista de transferência, por si só, não o adiciona aos dados da mensagem. Transfira o buffer de um array tipado, não o próprio array tipado como elemento da lista de transferência.
Envie uma resposta dentro do worker com self.postMessage(...) e receba-a no objeto worker. Isto não é window.postMessage: não existe um argumento targetOrigin. SharedWorker utiliza worker.port.postMessage(...). Esta API é definida pelo HTML Living Standard, não por uma edição de ECMAScript. O método básico é suportado nos motores de browser modernos; verifique separadamente a compatibilidade da forma de transferência utilizada. Node 24 não comprova a disponibilidade desta API de browser.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.