CKTIS / JavaScript
DedicatedWorkerGlobalScope.postMessage() — enviar mensagens a partir de um worker
DedicatedWorkerGlobalScope.postMessage envia dados de um worker dedicado para quem o criou. O destinatário lê-os através de event.data. O método suporta clonagem estruturada e transferência opcional da propriedade de objetos.
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
self.postMessage(message)
self.postMessage(message, transfer)
self.postMessage(message, { transfer })DedicatedWorkerGlobalScope.postMessage é um método da API Web disponível dentro de um worker dedicado como self.postMessage(). Envia uma mensagem para quem criou o worker. O destinatário trata o evento message no objeto Worker e lê event.data. No sentido inverso, utiliza-se Worker.postMessage().
O argumento message contém um único valor; agrupe vários elementos num objeto ou numa matriz. A clonagem estruturada também suporta referências circulares. A matriz opcional transfer, fornecida diretamente ou como { transfer }, transfere a propriedade dos objetos suportados em vez de os copiar. Depois disso, deixam de poder ser utilizados do lado do envio. A lista, por si só, não inclui objetos na mensagem: estes têm de estar contidos nela ou estar acessíveis ao destinatário por outra via.
O método devolve undefined, não a resposta do destinatário. Esta é uma API do navegador, não uma funcionalidade ECMAScript; a MDN assinala-a como amplamente disponível. O exemplo cria um worker dedicado, envia 21 e apresenta a resposta 42.
Exemplos
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
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.