CKTIS / JavaScript
MessageEvent: source, origin y data
Distingue la referencia al remitente, su origen al enviar y los datos que debes validar antes de procesar un mensaje entre ventanas.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
event.source
event.origin
event.datasource, origin y data son propiedades de instancia de MessageEvent de solo lectura. Pertenecen a una API de la plataforma web, no a ECMAScript 2024; su disponibilidad depende del entorno de ejecución.
Con Window.postMessage(), event.source es el WindowProxy del contexto de navegación del remitente. Si una ventana se envía un mensaje a sí misma, el remitente y el destinatario tienen el mismo WindowProxy. Según la API, source también puede ser un MessagePort (por ejemplo, en el evento connect de un worker compartido), un ServiceWorker o null. En un evento message normal recibido mediante un MessagePort, source vale null y origin vale "".
En la comunicación entre ventanas, event.origin contiene el origen serializado del remitente en el momento del envío: esquema, host y, si corresponde, puerto, sin ruta, consulta ni fragmento. El mismo WindowProxy puede apuntar a otro documento después de una navegación, así que origin no indica qué documento está cargado ahora. Un origen opaco se serializa como la cadena "null", distinta de la cadena vacía "" y del valor null de JavaScript.
event.data contiene los datos enviados. Window.postMessage() utiliza la clonación estructurada, no JSON ni una referencia directa al objeto original. Enviar un valor que no se puede clonar, como una función, lanza DataCloneError en el lado emisor.
Antes de actuar sobre data, compara origin con el origen exacto esperado mediante ===, comprueba source si sabes qué ventana esperas y valida la estructura y los valores de los datos. Al enviar o responder, indica un targetOrigin exacto si se conoce. Restringe el destinatario, pero no sustituye las comprobaciones que este hace al recibir el mensaje. No envíes datos confidenciales con "*".
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>MessageEvent: source, origin, and data</title>
</head>
<body>
<script>
(() => {
const expectedOrigin = window.location.origin;
const expectedSource = window;
function receive(event) {
if (event.origin !== expectedOrigin || event.source !== expectedSource) return;
const data = event.data;
if (data === null || typeof data !== "object" ||
data.type !== "cktis:count" || !Number.isInteger(data.count)) return;
window.removeEventListener("message", receive);
console.log(`source === window: ${event.source === window}`);
console.log(`origin === expectedOrigin: ${event.origin === expectedOrigin}`);
console.log(`data.count: ${data.count}`);
}
window.addEventListener("message", receive);
window.postMessage({ type: "cktis:count", count: 7 }, expectedOrigin);
})();
</script>
</body>
</html>Resultado
source === window: true origin === expectedOrigin: true data.count: 7
Sirve el archivo HTML por HTTP(S) y ábrelo en una pestaña del navegador sin restricciones de sandbox. La ventana se envía un mensaje a sí misma. Las tres líneas aparecen de forma asíncrona en la consola del navegador después de que el manejador acepte el mensaje y retire el listener.
Lecciones relacionadas
- JavaScript · Lección 5 · Avanzado · Versión: 4