CKTIS / JavaScript
iframe: de eigenschap contentWindow en het event load
`contentWindow` geeft een verwijzing naar het venster van het iframe. `load` meldt dat een laadpoging is afgelopen, maar bevestigt geen succes en geeft geen toegang tot de DOM.
Versie: 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 is alleen-lezen. De eigenschap geeft de WindowProxy van de browsecontext terug, of null als die context ontbreekt, zoals bij een pas gemaakt iframe dat nog niet is ingevoegd. Bij navigaties binnen dezelfde browsecontext blijft de proxy hetzelfde object, ook als de onderliggende Window en Document veranderen. De proxy zegt op zichzelf niet dat het beoogde document gereed is.
Registreer de listener voor load op het iframe-element, niet op zijn venster, voordat je het invoegt of de te volgen navigatie start. Bij een latere navigatie kan het event opnieuw optreden; met { once: true } wordt de listener verwijderd vlak voordat die voor het eerst wordt aangeroepen. load kan ook optreden als laden mislukt, en het element meldt die mislukking niet met error. Geen van beide events verleent toegang of bevestigt dat de ingebedde toepassing gereed is.
Je kunt iframe.contentWindow.document lezen als het framedocument en de bovenliggende pagina dezelfde origin hebben. Bij verschillende origins veroorzaakt die toegang een SecurityError; iframe.contentDocument geeft in plaats daarvan null terug. sandbox zonder allow-same-origin kan het framedocument een ondoorzichtige origin geven. Gebruik voor communicatie met een meewerkend iframe met een andere, bekende origin postMessage() met een exacte targetOrigin. De ontvanger moet event.origin, event.source en de structuur van de berichtgegevens controleren.
Dit zijn API’s van het webplatform, geen functies van ECMAScript 2024. Het voorbeeld vereist een browser met een DOM; ondersteuning en beveiligingsbeleid hangen af van de omgeving.
Voorbeelden
<!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>Resultaat
true Frame ready
Sla het voorbeeld op als HTML-bestand, bied het aan via HTTP(S) en open het in een browser. De pagina moet het inline-script, het iframe en de toewijzing aan `srcdoc` toestaan. In de browserconsole verschijnt vóór het invoegen `true` en in de `load`-handler `Frame ready`. De code gebruikt een vaste, vertrouwde `srcdoc`-string, haalt geen extern document op en verwijdert het iframe na het lezen van de titel.
Gerelateerde lessen
- JavaScript · Les 5 · Gevorderd · Versie: 4