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

CKTIS / JavaScript

Eventos de Worker: mensagens e erros

Worker.onmessage recebe respostas do worker, Worker.onerror assinala falhas do worker e Worker.onmessageerror trata a desserialização mal-sucedida de uma mensagem recebida. Estes três processadores pertencem ao objeto Worker no código que criou o worker.

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.onmessage = (event) => { /* event.data */ };
worker.onerror = (event) => { /* worker failure */ };
worker.onmessageerror = (event) => { /* deserialization failure */ };

Worker.onmessage, Worker.onerror e Worker.onmessageerror são propriedades atribuídas a uma instância, como worker.onmessage. Tratam, respetivamente, os eventos message, error e messageerror do lado que criou um worker dedicado. São APIs Web especificadas por HTML, não funcionalidades de uma edição específica de ECMAScript.

Worker.onmessage recebe um MessageEvent; o valor transmitido encontra-se em event.data. Chamar worker.postMessage(value) envia dados para o worker, enquanto self.postMessage(value) dentro do worker envia uma resposta. Por sua vez, Worker.onerror recebe um argumento de evento que assinala uma falha do worker. Não o confundas com self.onerror dentro do worker, que tem uma assinatura histórica com vários argumentos.

Worker.onmessageerror recebe um MessageEvent quando não é possível desserializar uma mensagem recebida. Não é um processador geral de erros de cálculo nem substitui o tratamento de exceções do lado do emissor. Os dados passados a postMessage() têm de ser suportados pelo algoritmo de clonagem estruturada. Nem message nem messageerror se propagam para cima ou podem ser cancelados.

As alternativas são addEventListener("message", handler), addEventListener("error", handler) e addEventListener("messageerror", handler). A MDN assinala message e error como amplamente disponíveis, mas messageerror como tendo disponibilidade limitada; verifica os browsers de destino. A presença de Node 24 num repositório não comprova o suporte destas APIs nos browsers.

Exemplos

(() => {
  const source = 'self.onmessage = (event) => { self.postMessage(event.data * 2); };';
  const url = URL.createObjectURL(new Blob([source], { type: 'text/javascript' }));
  let worker;
  const cleanup = () => {
    worker?.terminate();
    URL.revokeObjectURL(url);
  };

  try {
    worker = new Worker(url);
    worker.onmessage = (event) => {
      console.log(`result: ${event.data}`);
      cleanup();
    };
    worker.onerror = () => {
      console.error('worker error');
      cleanup();
    };
    worker.onmessageerror = () => {
      console.error('message deserialization error');
      cleanup();
    };
    worker.postMessage(21);
  } catch (error) {
    cleanup();
    throw error;
  }
})();

Resultado

result: 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