Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori