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

CKTIS / HTML

onmessageerror — tratar falhas de desserialização de mensagens

O atributo onmessageerror de body define o processador messageerror do objeto Window. O evento indica que falhou a desserialização de uma mensagem recebida, e não um erro de comunicação genérico.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<body onmessageerror="handler(event)">
window.onmessageerror = handler;
window.addEventListener("messageerror", handler);

onmessageerror é um atributo HTML de processamento de eventos para messageerror. Em body, define um processador para o Window associado, não para um evento dirigido ao próprio elemento. Não é um atributo global destinado a qualquer elemento. O valor do atributo é código JavaScript; o parâmetro event disponibiliza um MessageEvent.

Na comunicação através de postMessage(), o destinatário reconstrói os dados transmitidos usando desserialização estruturada. Se essa etapa falhar, recebe messageerror em vez de message. Isto não é um aviso geral de mensagens perdidas nem um erro na execução do código do destinatário. Uma falha de serialização no lado do emissor pode, por sua vez, lançar uma exceção síncrona DataCloneError durante a chamada a postMessage().

Em JavaScript, atribua uma função a window.onmessageerror ou use window.addEventListener("messageerror", handler). O atributo em body e a propriedade window.onmessageerror referem-se ao mesmo processador; uma atribuição posterior substitui-o e atribuir null remove-o. addEventListener() permite adicionar ouvintes independentes.

O exemplo envia deliberadamente um evento sintético para window, para obter um resultado determinístico. Verifica a ligação do atributo ao processador de eventos, mas não provoca uma falha real de desserialização. Uma política de segurança que bloqueie scripts ou processadores de eventos inline pode impedir a sua execução.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onmessageerror demo</title>
<body onmessageerror="document.getElementById('result').textContent = event.type">
<pre id="result">waiting</pre>
<script>
  window.dispatchEvent(new MessageEvent('messageerror'));
</script>
</body>
</html>

Resultado

messageerror

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