CKTIS / JavaScript
iframe: Die Eigenschaft contentWindow und das Ereignis load
`contentWindow` liefert eine Referenz auf das Fenster des iframe. `load` meldet einen abgeschlossenen Ladeversuch, bestätigt aber weder den Erfolg noch erlaubt es den DOM-Zugriff.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const frameWindow = iframe.contentWindow;
iframe.addEventListener("load", handler);
iframe.addEventListener("load", handler, { once: true });iframe.contentWindow ist schreibgeschützt und liefert den WindowProxy des Browsing-Kontexts oder null, wenn kein solcher Kontext existiert, etwa bei einem neuen iframe vor dem Einfügen. Bei Navigationen im selben Browsing-Kontext bleibt die Identität des Proxys erhalten, auch wenn sich die zugrunde liegenden Objekte Window und Document ändern. Der Proxy allein zeigt nicht an, dass das gewünschte Dokument bereit ist.
Registriere den Listener für load am iframe-Element, nicht an dessen Fenster, und zwar vor dem Einfügen oder vor der Navigation, die du beobachten willst. Eine spätere Navigation kann das Ereignis erneut auslösen; mit { once: true } wird der Listener unmittelbar vor seinem ersten Aufruf entfernt. load kann auch bei einem Ladefehler ausgelöst werden; das Element meldet diesen Fehler nicht mit error. Keines dieser Ereignisse gewährt Zugriff oder bestätigt, dass die eingebettete Anwendung bereit ist.
iframe.contentWindow.document ist lesbar, wenn iframe und übergeordnete Seite denselben Ursprung haben. Bei unterschiedlichen Ursprüngen löst der Zugriff SecurityError aus; iframe.contentDocument liefert stattdessen null. sandbox ohne allow-same-origin kann dem Dokument einen opaken Ursprung geben. Verwende für eine kooperierende Seite mit einem anderen, bekannten Ursprung postMessage() mit einem exakten targetOrigin. Auf der Empfängerseite sind event.origin, event.source und die Struktur der Nachrichtendaten zu prüfen.
Das sind APIs der Webplattform, keine Funktionen von ECMAScript 2024. Das Beispiel benötigt einen Browser mit DOM; Unterstützung und Sicherheitsrichtlinien hängen von der Umgebung ab.
Beispiele
<!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>Ergebnis
true Frame ready
Speichere das Beispiel als HTML-Datei, stelle sie über HTTP(S) bereit und öffne sie im Browser. Die Seite muss das Inline-Skript, das iframe und die Zuweisung an `srcdoc` zulassen. In der Browserkonsole erscheint vor dem Einfügen `true` und im `load`-Handler danach `Frame ready`. Der feste, vertrauenswürdige `srcdoc`-String lädt kein externes Dokument. Nach dem Lesen des Titels wird das iframe entfernt.
Zugehörige Lektionen
- JavaScript · Lektion 5 · Fortgeschritten · Version: 4