CKTIS / JavaScript
window.postMessage — comunicación entre ventanas
window.postMessage envía datos de forma asíncrona a una ventana de destino, incluso entre distintos orígenes. Se recomienda especificar un `targetOrigin` exacto; si se omite, la entrega se limita al mismo origen. El receptor debe comprobar el origen del emisor, la ventana emisora y la estructura de los datos.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
targetWindow.postMessage(message, targetOrigin[, transfer])
targetWindow.postMessage(message[, { targetOrigin, transfer }])window.postMessage es una API del navegador definida por HTML Living Standard, no una función de una edición concreta de ECMAScript. Los motores de navegador actuales la admiten; la presencia de Node 24 en un repositorio no demuestra que esté disponible. Llama al método en la ventana receptora, como iframe.contentWindow o una referencia a una ventana abierta. Enviar mensajes no da acceso al DOM de otro origen.
El receptor recibe un evento message asíncrono: event.data contiene los datos, event.origin contiene el origen serializado del emisor en el momento del envío y event.source hace referencia a la ventana emisora. Un origen representado por una tupla se identifica por el esquema, el host y el puerto, no por la ruta. Un origen opaco no tiene esa tupla y se serializa como la cadena "null". Comprobar solo esa cadena no permite distinguir un origen opaco de otro. Registra el listener antes de enviar; si se trata de un frame nuevo, coordina que el receptor esté preparado.
Especifica un targetOrigin exacto. Si no coincide con el origen del receptor, el mensaje se descarta. En la forma con un objeto de opciones, omitir targetOrigin equivale a "/" y limita la entrega al mismo origen. "*" permite cualquier origen: no lo uses para datos confidenciales. Los receptores deben validar event.origin, event.source y la estructura de los datos; nunca deben tratar los mensajes como código.
Los datos se serializan mediante el algoritmo de clonación estructurada, no como JSON. Las funciones no se pueden clonar. La lista transfer mueve recursos en lugar de copiarlos: un ArrayBuffer transferido queda desconectado en el lado emisor. Los datos que no se puedan clonar o las entradas duplicadas en la lista de transferencia pueden causar un DataCloneError. En el ejemplo, un iframe aislado mediante sandbox envía un mensaje a su ventana padre con window.parent.postMessage. La ventana padre comprueba que event.origin vale "null" y que event.source corresponde a la ventana del iframe. Después valida los datos y muestra received: 42 en la consola.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Send a message from an iframe</title>
</head>
<body>
<script>
const frame = document.createElement('iframe');
frame.title = 'Message sender';
frame.hidden = true;
frame.setAttribute('sandbox', 'allow-scripts');
// Use the page's exact origin when it has an HTTP(S) origin.
// The wildcard fallback carries only the fixed, non-sensitive fixture.
const targetOrigin = /^https?:\/\//.test(window.origin) ? window.origin : '*';
function receive(event) {
// The sandboxed sender has an opaque origin, serialized as "null".
if (event.origin !== 'null' || event.source !== frame.contentWindow) return;
const data = event.data;
if (data === null || typeof data !== 'object' || Array.isArray(data)) return;
if (data.type !== 'cktis-demo' || data.value !== 42) return;
window.removeEventListener('message', receive);
console.log(`received: ${data.value}`);
}
window.addEventListener('message', receive);
frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Message sender</title></head>
<body>
<script>
window.parent.postMessage({ type: 'cktis-demo', value: 42 }, ${JSON.stringify(targetOrigin)});
<\/script>
</body>
</html>`;
document.body.append(frame);
</script>
</body>
</html>Resultado
received: 42
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.