CKTIS / JavaScript
HTMLIFrameElement: contentWindow en het load-event
HTMLIFrameElement stelt een ingesloten frame voor. De eigenschap contentWindow geeft toegang tot het venster van het frame, terwijl load een reactie mogelijk maakt wanneer het laden klaar is. Toegang tot het document hangt af van hetzelfde oorsprongsbeleid; load alleen bevestigt niet dat het ophalen is geslaagd.
Versie: 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 is de DOM-interface voor een iframe-element, geen functie van de ECMAScript-taal. „Iframe contentWindow and load” combineert toegang tot het venster van een frame met het afhandelen van het laden ervan. Dit is een browser-API; de aanwezigheid van Node 24 bewijst niet dat deze beschikbaar is. De basisinterface en contentWindow worden breed ondersteund, maar aanvullende eigenschappen moeten afzonderlijk op compatibiliteit worden gecontroleerd.
De alleen-lezen eigenschap contentWindow geeft via een WindowProxy toegang tot het venster van de ingesloten context. Het same-originbeleid beperkt de toegang: contentWindow.document lezen is toegestaan bij een frame met dezelfde oorsprong, maar veroorzaakt een uitzondering bij een frame met een andere oorsprong. Gebruik voor communicatie tussen verschillende oorsprongen postMessage en controleer aan de ontvangende kant de verwachte waarden van event.origin en event.source.
Registreer load op het frame zelf voordat je het laden start of het aan het document toevoegt. Het event bubbelt niet en kan niet worden geannuleerd. Zie het niet als bewijs van een geslaagde download: frames activeren load ook wanneer het laden mislukt en activeren geen overeenkomstige error. De optie { once: true } handelt alleen het eerste event af, niet latere navigaties.
Het voorbeeld wijst via srcdoc een vast document toe, leest de tekst na load en verwijdert het frame. Zonder sandbox-beperkingen heeft dat document dezelfde oorsprong als het bovenliggende document. srcdoc interpreteert HTML: geef er geen niet-vertrouwde gegevens aan door. CSP of een vereiste voor TrustedHTML kan het voorbeeld blokkeren.
Voorbeelden
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);Resultaat
Ready
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.