CKTIS / JavaScript
HTMLIFrameElement: contentWindow i događaj load
HTMLIFrameElement predstavlja ugrađeni okvir. Njegovo svojstvo contentWindow izlaže prozor okvira, a događaj load omogućuje reakciju na završetak učitavanja. Pristup dokumentu ovisi o pravilu istog podrijetla, a sam load ne potvrđuje uspješno dohvaćanje.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
iframe.contentWindow
iframe.addEventListener("load", handler);
iframe.srcdoc = trustedMarkup;HTMLIFrameElement je DOM sučelje za element iframe, a ne značajka jezika ECMAScript. „Iframe contentWindow and load” povezuje pristup prozoru okvira s obradom njegova učitavanja. Riječ je o API-ju preglednika; prisutnost Node 24 ne dokazuje njegovu dostupnost. Osnovno sučelje i contentWindow široko su podržani, ali kompatibilnost dodatnih svojstava treba zasebno provjeriti.
Svojstvo contentWindow, koje je samo za čitanje, izlaže prozor ugrađenog konteksta putem WindowProxy. Pravilo istog podrijetla ograničava pristup: čitanje contentWindow.document dopušteno je za okvir istog podrijetla, ali za okvir drugog podrijetla izaziva iznimku. Za komunikaciju između različitih podrijetla koristi postMessage i na strani primatelja provjeri očekivane vrijednosti event.origin i event.source.
Registriraj load na samom okviru prije početka učitavanja ili njegova dodavanja u dokument. Događaj se ne širi prema gore i ne može se otkazati. Nemoj ga smatrati dokazom uspješnog dohvaćanja: okviri pokreću load i kada učitavanje ne uspije te ne pokreću odgovarajući error. Opcija { once: true } obrađuje samo prvi događaj, a ne i naknadne navigacije.
Primjer putem srcdoc postavlja fiksni dokument, čita njegov tekst nakon događaja load i uklanja okvir. Bez ograničenja sandbox, taj dokument ima isto podrijetlo kao nadređeni dokument. srcdoc tumači HTML: nemoj mu prosljeđivati nepouzdane podatke. CSP ili zahtjev za TrustedHTML mogu blokirati primjer.
Primjeri
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);Rezultat
Ready
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.