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.