CKTIS / HTML
onmessage — gestionar mensajes de la ventana
El atributo onmessage de body establece el controlador del evento message del objeto Window. Recibe, entre otros, mensajes enviados mediante postMessage; comprueba el emisor y los datos antes de usar los datos recibidos.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<body onmessage="handleMessage(event)">
window.onmessage = handleMessage;
window.addEventListener("message", handleMessage);onmessage es un atributo controlador del evento message. En HTML, puede aparecer en el elemento body; no es un atributo global. Su código gestiona eventos del objeto Window, no mensajes dirigidos al propio elemento body. El valor del atributo es código JavaScript que tiene acceso al parámetro event.
En JavaScript, window.onmessage = handleMessage establece el mismo controlador. Una asignación posterior lo reemplaza, y asignar null lo elimina. window.addEventListener("message", handleMessage) permite registrar otros escuchadores sin reemplazar ese controlador.
Un mensaje enviado mediante postMessage se entrega de forma asíncrona como un MessageEvent: event.data contiene los datos, event.origin identifica el origen del emisor y event.source identifica la fuente. Comprueba el origen y la fuente esperados, así como la estructura de los datos. Al enviar, especifica el origen de destino exacto en vez de "*", especialmente si los datos son confidenciales. El atributo por sí solo no envía mensajes.
El ejemplo envía un mensaje a la misma ventana. Ejecútalo mediante HTTP local, no como documento file:. El resultado esperado es que Waiting cambie a Hello. Una CSP que bloquee el código en línea puede impedir que se ejecute el script o el atributo; en ese entorno, mueve el código a un archivo JavaScript permitido y usa addEventListener.
Ejemplos
<!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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.