Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes