CKTIS / JavaScript
iframe: la propiedad contentWindow y el evento load
`contentWindow` da una referencia a la ventana del iframe. `load` indica que ha terminado un intento de carga, pero no confirma que haya tenido éxito ni permite acceder al DOM.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const frameWindow = iframe.contentWindow;
iframe.addEventListener("load", handler);
iframe.addEventListener("load", handler, { once: true });iframe.contentWindow es una propiedad de solo lectura. Devuelve el WindowProxy del contexto de navegación del iframe, o null si todavía no hay contexto, como ocurre con un iframe recién creado antes de insertarlo. En las navegaciones dentro del mismo contexto, el proxy conserva su identidad aunque cambien los objetos Window y Document subyacentes. Tener el proxy no significa que el documento esperado esté listo.
Registra el listener de load en el elemento iframe, no en su ventana, antes de insertarlo o de iniciar la navegación que quieras observar. Otra navegación puede volver a disparar el evento; con { once: true }, el listener se elimina justo antes de invocarlo por primera vez. load también puede dispararse si falla la carga, y el elemento no emite error para informar de ese fallo. Ninguno de estos eventos concede acceso ni confirma que la aplicación incrustada esté lista.
Puedes leer iframe.contentWindow.document si el documento del iframe y la página contenedora son del mismo origen. Si sus orígenes difieren, ese acceso lanza SecurityError, mientras que iframe.contentDocument devuelve null. Un sandbox sin allow-same-origin puede asignar al documento un origen opaco. Para comunicarte con un iframe cooperante de otro origen conocido, usa postMessage() con un targetOrigin exacto; quien recibe el mensaje debe comprobar event.origin, event.source y la estructura de los datos.
Son API de la plataforma web, no características de ECMAScript 2024. El ejemplo requiere un navegador con DOM; la compatibilidad y las políticas de seguridad dependen del entorno.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>iframe contentWindow and load</title>
</head>
<body>
<script>
(() => {
const iframe = document.createElement("iframe");
console.log(iframe.contentWindow === null);
iframe.srcdoc = "<!doctype html><title>Frame ready</title>";
iframe.addEventListener("load", () => {
console.log(iframe.contentWindow.document.title);
iframe.remove();
}, { once: true });
document.body.append(iframe);
})();
</script>
</body>
</html>Resultado
true Frame ready
Guarda el ejemplo como archivo HTML, sírvelo por HTTP(S) y ábrelo en un navegador. La página debe permitir el script en línea, el iframe y la asignación a `srcdoc`. La consola del navegador muestra `true` antes de insertar el iframe y `Frame ready` en el manejador de `load`. El ejemplo usa una cadena `srcdoc` fija y de confianza, no carga ningún documento externo y elimina el iframe tras leer su título.
Lecciones relacionadas
- JavaScript · Lección 5 · Avanzado · Versión: 4