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

CKTIS / HTML

onmessage — tratar mensagens da janela

O atributo onmessage de body define o processador do evento message do objeto Window. Recebe, entre outras, mensagens enviadas através de postMessage; verifique o emissor e os dados antes de os utilizar.

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

Sintaxe

<body onmessage="handleMessage(event)">
window.onmessage = handleMessage;
window.addEventListener("message", handleMessage);

onmessage é um atributo processador do evento message. Em HTML, pode surgir no elemento body; não é um atributo global. O seu código trata eventos do objeto Window, não mensagens dirigidas ao próprio elemento body. O valor do atributo é código JavaScript com acesso ao parâmetro event.

Em JavaScript, window.onmessage = handleMessage define o mesmo processador. Uma atribuição posterior substitui-o e atribuir null remove-o. window.addEventListener("message", handleMessage) permite registar outros ouvintes sem substituir esse processador.

Uma mensagem enviada através de postMessage é entregue de forma assíncrona como um MessageEvent: event.data contém os dados, event.origin identifica a origem do emissor e event.source identifica a fonte. Verifique a origem e a fonte esperadas, bem como a estrutura dos dados. Ao enviar, indique a origem de destino exata em vez de "*", sobretudo no caso de dados confidenciais. O atributo, por si só, não envia mensagens.

O exemplo envia uma mensagem para a mesma janela. Execute-o através de HTTP local, não como um documento file:. O resultado esperado é que Waiting mude para Hello. Uma CSP que bloqueie código inline pode impedir a execução do script ou do atributo; nesse ambiente, coloque o código num ficheiro JavaScript permitido e use addEventListener.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Body onmessage handler</title>
</head>
<body onmessage="if (event.source === window &amp;&amp; event.origin === window.origin &amp;&amp; event.data === 'Hello') document.getElementById('result').textContent = event.data;">
  <p id="result" aria-live="polite">Waiting</p>
  <script>
    // The destination is this same window, and the payload is not sensitive.
    // A wildcard also works when the document has an opaque origin.
    window.postMessage('Hello', '*');
  </script>
</body>
</html>

Resultado

Hello

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