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

CKTIS / JavaScript

messageerror — falha de desserialização de uma mensagem do Worker

O evento messageerror num Worker indica que não foi possível desserializar uma mensagem recebida. Distingue-o de uma falha de envio em postMessage() e do evento error associado a um erro do 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.addEventListener("messageerror", (event) => { /* handle receive failure */ });
worker.onmessageerror = (event) => { /* handle receive failure */ };

O messageerror event é emitido num objeto Worker quando não é possível desserializar uma mensagem recebida do worker, ou seja, reconstruir o seu valor no lado recetor. Faz parte das Web APIs, não de uma edição específica de ECMAScript. O evento é um MessageEvent, não propaga e não pode ser cancelado.

Regista um handler com worker.addEventListener("messageerror", handler) ou atribui uma função a worker.onmessageerror. A primeira forma permite vários listeners; a segunda define uma única propriedade de handler. A direção é importante: um listener em Worker trata da receção no código que criou o worker. Dentro de um worker dedicado, usa self.addEventListener("messageerror", handler) para tratar da receção do seu criador.

Não confundas este evento com todos os problemas de comunicação. Tentar enviar um valor que não pode ser clonado pode provocar uma exceção síncrona DataCloneError em postMessage() — trata-a com try...catch no emissor. O evento error diz respeito a um erro do worker, não especificamente à desserialização de uma mensagem. messageerror também não valida os dados da aplicação; uma mensagem recebida com sucesso continua a precisar de validação.

O exemplo envia intencionalmente um MessageEvent sintético para um EventTarget simples. Assim demonstra de forma determinística a execução do listener e as flags do evento, sem ficheiros de worker. Não provoca uma falha real de desserialização nem comprova o suporte nativo do evento em Worker. A MDN assinala que a variante Worker tem disponibilidade limitada: verifica a compatibilidade dos browsers de destino. A presença de Node 24 num repositório não comprova o suporte desta API nos browsers.

Exemplos

(() => {
  const target = new EventTarget();
  target.addEventListener("messageerror", (event) => {
    console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
  });
  target.dispatchEvent(new MessageEvent("messageerror"));
})();

Resultado

messageerror: bubbles=false, cancelable=false

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