CKTIS / JavaScript
HTMLIFrameElement: contentWindow und das load-Ereignis
HTMLIFrameElement steht für einen eingebetteten Frame. Die Eigenschaft contentWindow stellt dessen Fenster bereit, während load die Reaktion auf das Ende des Ladevorgangs ermöglicht. Der Dokumentzugriff hängt von der Same-Origin-Policy ab; load allein bestätigt keinen erfolgreichen Abruf.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
iframe.contentWindow
iframe.addEventListener("load", handler);
iframe.srcdoc = trustedMarkup;HTMLIFrameElement ist die DOM-Schnittstelle für ein iframe-Element und kein Merkmal der ECMAScript-Sprache. „Iframe contentWindow and load“ verbindet den Zugriff auf das Fenster eines Frames mit der Behandlung seines Ladevorgangs. Dies ist eine Browser-API; das Vorhandensein von Node 24 belegt nicht ihre Verfügbarkeit. Die grundlegende Schnittstelle und contentWindow werden breit unterstützt, zusätzliche Eigenschaften müssen jedoch separat auf Kompatibilität geprüft werden.
Die schreibgeschützte Eigenschaft contentWindow stellt das Fenster des eingebetteten Kontexts über einen WindowProxy bereit. Die Same-Origin-Policy beschränkt den Zugriff: Das Lesen von contentWindow.document ist bei einem Frame gleichen Ursprungs erlaubt, löst bei einem Frame mit anderem Ursprung jedoch eine Ausnahme aus. Verwende für die ursprungsübergreifende Kommunikation postMessage und prüfe beim Empfänger das erwartete event.origin und event.source.
Registriere load am Frame selbst, bevor du den Ladevorgang startest oder ihn an das Dokument anhängst. Das Ereignis steigt nicht in der Ereignishierarchie auf und kann nicht abgebrochen werden. Betrachte es nicht als Beweis für einen erfolgreichen Abruf: Frames lösen load auch aus, wenn das Laden fehlschlägt, und lösen kein entsprechendes error aus. Die Option { once: true } verarbeitet nur das erste Ereignis, nicht spätere Navigationen.
Das Beispiel weist über srcdoc ein festes Dokument zu, liest nach load dessen Text aus und entfernt den Frame. Ohne sandbox-Beschränkungen hat dieses Dokument denselben Ursprung wie sein übergeordnetes Dokument. srcdoc interpretiert HTML: Übergib keine nicht vertrauenswürdigen Daten. CSP oder eine Anforderung für TrustedHTML können das Beispiel blockieren.
Beispiele
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);Ergebnis
Ready
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.