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.