CKTIS / JavaScript
HTMLIFrameElement: contentWindow a událost load
HTMLIFrameElement představuje vložený rámec. Jeho vlastnost contentWindow zpřístupňuje okno rámce, zatímco load umožňuje reagovat na dokončení načítání. Přístup k dokumentu závisí na zásadě stejného původu a samotná událost load nepotvrzuje úspěšné načtení.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
iframe.contentWindow
iframe.addEventListener("load", handler);
iframe.srcdoc = trustedMarkup;HTMLIFrameElement je rozhraní DOM pro prvek iframe, nikoli funkce jazyka ECMAScript. „Iframe contentWindow and load“ spojuje přístup k oknu rámce se zpracováním jeho načítání. Jde o rozhraní API prohlížeče; přítomnost Node 24 nedokazuje jeho dostupnost. Základní rozhraní a contentWindow jsou široce podporovány, kompatibilitu dalších vlastností je však nutné ověřit samostatně.
Vlastnost contentWindow určená pouze pro čtení zpřístupňuje okno vloženého kontextu prostřednictvím WindowProxy. Zásada stejného původu přístup omezuje: čtení contentWindow.document je u rámce stejného původu povoleno, u rámce jiného původu však vyvolá výjimku. Ke komunikaci mezi různými původy použij postMessage a na straně příjemce ověř očekávané hodnoty event.origin a event.source.
Událost load zaregistruj přímo na rámci ještě před zahájením načítání nebo jeho připojením k dokumentu. Událost se nešíří vzhůru a nelze ji zrušit. Nepovažuj ji za důkaz úspěšného načtení: rámce vyvolají load i při neúspěšném načítání a odpovídající error nevyvolají. Možnost { once: true } zpracuje pouze první událost, nikoli další navigace.
Příklad přiřadí pomocí srcdoc pevný dokument, po události load přečte jeho text a rámec odstraní. Bez omezení sandbox má tento dokument stejný původ jako jeho nadřazený dokument. srcdoc interpretuje HTML: nepředávej do něj nedůvěryhodná data. CSP nebo požadavek na TrustedHTML mohou příklad zablokovat.
Příklady
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);Výsledek
Ready
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.