Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje