CKTIS / JavaScript
HTMLIFrameElement: contentWindow y el evento load
HTMLIFrameElement representa un marco integrado. Su propiedad contentWindow expone la ventana del marco, mientras que load permite reaccionar cuando termina la carga. El acceso al documento depende de la política del mismo origen, y load por sí solo no confirma que la descarga haya tenido éxito.
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
iframe.contentWindow
iframe.addEventListener("load", handler);
iframe.srcdoc = trustedMarkup;HTMLIFrameElement es la interfaz DOM de un elemento iframe, no una característica del lenguaje ECMAScript. «Iframe contentWindow and load» combina el acceso a la ventana de un marco con la gestión de su carga. Esta es una API del navegador; la presencia de Node 24 no demuestra que esté disponible. La interfaz principal y contentWindow cuentan con amplia compatibilidad, pero las propiedades adicionales deben comprobarse por separado.
La propiedad de solo lectura contentWindow expone la ventana del contexto integrado mediante un WindowProxy. La política del mismo origen restringe el acceso: se permite leer contentWindow.document en un marco del mismo origen, pero se produce una excepción si el marco tiene otro origen. Para la comunicación entre distintos orígenes, usa postMessage y comprueba en el receptor los valores esperados de event.origin y event.source.
Registra load en el propio marco antes de iniciar la carga o añadirlo al documento. El evento no se propaga hacia arriba y no se puede cancelar. No lo consideres prueba de que la descarga haya tenido éxito: los marcos disparan load incluso si la carga falla y no disparan un error correspondiente. La opción { once: true } gestiona solo el primer evento, no las navegaciones posteriores.
El ejemplo asigna un documento fijo mediante srcdoc, lee su texto después de load y elimina el marco. Sin restricciones sandbox, ese documento tiene el mismo origen que su elemento principal. srcdoc interpreta HTML: no le pases datos no confiables. La CSP o un requisito de TrustedHTML pueden bloquear el ejemplo.
Ejemplos
const iframe = document.createElement("iframe");
iframe.title = "Demo";
iframe.addEventListener("load", () => {
const childWindow = iframe.contentWindow;
console.log(childWindow.document.querySelector("p").textContent);
iframe.remove();
}, { once: true });
iframe.srcdoc = '<!doctype html><html lang="en"><title>Demo</title><body><p>Ready</p></body></html>';
document.body.append(iframe);Resultado
Ready
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.