Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLIFrameElement: contentWindow in dogodek load

HTMLIFrameElement predstavlja vdelani okvir. Njegova lastnost contentWindow omogoča dostop do okna okvira, load pa omogoča odziv na konec nalaganja. Dostop do dokumenta je odvisen od pravil istega izvora; sam load ne potrjuje uspešnega prenosa.

Različica: 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 vmesnik DOM za element iframe, ne funkcija jezika ECMAScript. »Iframe contentWindow and load« združuje dostop do okna okvira z obravnavo njegovega nalaganja. To je API brskalnika; prisotnost Node 24 ne dokazuje njegove razpoložljivosti. Osnovni vmesnik in contentWindow sta široko podprta, združljivost dodatnih lastnosti pa je treba preveriti posebej.

Lastnost contentWindow, ki je samo za branje, prek WindowProxy izpostavi okno vdelanega konteksta. Pravila istega izvora omejujejo dostop: branje contentWindow.document je pri okviru istega izvora dovoljeno, pri okviru drugega izvora pa sproži izjemo. Za komunikacijo med različnimi izvori uporabi postMessage in pri prejemniku preveri pričakovani vrednosti event.origin in event.source.

load registriraj na samem okviru, še preden začneš nalaganje ali ga pripneš dokumentu. Dogodek se ne širi navzgor in ga ni mogoče preklicati. Ne obravnavaj ga kot dokaz uspešnega prenosa: okvirji sprožijo load tudi ob neuspešnem nalaganju in ne sprožijo ustreznega dogodka error. Možnost { once: true } obdela le prvi dogodek, ne pa tudi poznejših navigacij.

Primer prek srcdoc nastavi nespremenljiv dokument, po dogodku load prebere njegovo besedilo in odstrani okvir. Brez omejitev sandbox ima ta dokument isti izvor kot nadrejeni dokument. srcdoc razčlenjuje HTML: vanj ne posreduj nezaupanja vrednih podatkov. CSP ali zahteva za TrustedHTML lahko primer blokira.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri