CKTIS / JavaScript
iframe: svojstvo contentWindow i događaj load
`contentWindow` daje referencu na prozor okvira. `load` označava kraj pokušaja učitavanja, ali ne potvrđuje uspjeh niti daje pristup DOM-u.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const frameWindow = iframe.contentWindow;
iframe.addEventListener("load", handler);
iframe.addEventListener("load", handler, { once: true });iframe.contentWindow svojstvo je samo za čitanje. Vraća WindowProxy konteksta pregledavanja okvira ili null ako kontekst ne postoji, primjerice kad je okvir stvoren, ali još nije umetnut u dokument. Pri navigacijama unutar istog konteksta proxy zadržava identitet i kad se promijene objekti Window i Document na koje upućuje. Postojanje proxyja ne znači da je željeni dokument spreman.
Registriraj slušatelj za load na elementu iframe, a ne na njegovu prozoru, prije umetanja elementa ili pokretanja navigacije koju želiš pratiti. Kasnija navigacija može ponovno pokrenuti događaj; uz { once: true } slušatelj se uklanja neposredno prije prvog poziva. load se može dogoditi i kad učitavanje ne uspije, a element taj neuspjeh ne prijavljuje događajem error. Nijedan od tih događaja ne daje pristup niti potvrđuje da je ugrađena aplikacija spremna.
iframe.contentWindow.document možeš čitati ako dokument okvira i nadređena stranica imaju isto podrijetlo. Ako se podrijetla razlikuju, pristup izaziva SecurityError, dok iframe.contentDocument vraća null. sandbox bez allow-same-origin može dokumentu dodijeliti neprozirno podrijetlo. Za komunikaciju s okvirom koji surađuje i ima drugo poznato podrijetlo koristi postMessage() s točnim targetOrigin; primatelj treba provjeriti event.origin, event.source i strukturu podataka poruke.
To su API-ji web-platforme, a ne značajke ECMAScripta 2024. Primjer zahtijeva preglednik s DOM-om; podrška i sigurnosna pravila ovise o okruženju.
Primjeri
<!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>Rezultat
true Frame ready
Spremi primjer kao HTML datoteku, posluži je preko HTTP(S)-a i otvori je u pregledniku. Stranica mora dopuštati umetnutu skriptu, okvir i dodjelu vrijednosti svojstvu `srcdoc`. U konzoli preglednika prije umetanja okvira ispisuje se `true`, a u rukovatelju događajem `load` ispisuje se `Frame ready`. Primjer koristi fiksni, pouzdani niz `srcdoc`, ne učitava vanjski dokument i uklanja okvir nakon čitanja naslova.
Povezane lekcije
- JavaScript · Lekcija 5 · Napredno · Verzija: 4