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 && event.origin === window.origin && 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.