Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

HTMLIFrameElement: contentWindow a udalosť load

HTMLIFrameElement predstavuje vložený rámec. Jeho vlastnosť contentWindow sprístupňuje okno rámca, zatiaľ čo load umožňuje reagovať na dokončenie načítania. Prístup k dokumentu závisí od zásady rovnakého pôvodu a samotná udalosť load nepotvrdzuje úspešné načítanie.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

iframe.contentWindow
iframe.addEventListener("load", handler);
iframe.srcdoc = trustedMarkup;

HTMLIFrameElement je rozhranie DOM pre prvok iframe, nie funkcia jazyka ECMAScript. „Iframe contentWindow and load“ spája prístup k oknu rámca so spracovaním jeho načítania. Ide o rozhranie API prehliadača; prítomnosť Node 24 nedokazuje jeho dostupnosť. Základné rozhranie a contentWindow sú široko podporované, kompatibilitu ďalších vlastností však treba overiť samostatne.

Vlastnosť contentWindow určená iba na čítanie sprístupňuje okno vloženého kontextu prostredníctvom WindowProxy. Zásada rovnakého pôvodu obmedzuje prístup: čítanie contentWindow.document je pri rámci rovnakého pôvodu povolené, pri rámci iného pôvodu však vyvolá výnimku. Na komunikáciu medzi rôznymi pôvodmi použi postMessage a na strane príjemcu over očakávané hodnoty event.origin a event.source.

Udalosť load zaregistruj priamo na rámci ešte pred začatím načítania alebo jeho pripojením k dokumentu. Udalosť sa nešíri nahor a nedá sa zrušiť. Nepovažuj ju za dôkaz úspešného načítania: rámce vyvolajú load aj pri neúspešnom načítaní a zodpovedajúcu udalosť error nevyvolajú. Možnosť { once: true } spracuje iba prvú udalosť, nie ďalšie navigácie.

Príklad priradí pomocou srcdoc pevný dokument, po udalosti load prečíta jeho text a rámec odstráni. Bez obmedzení sandbox má tento dokument rovnaký pôvod ako jeho nadradený dokument. srcdoc interpretuje HTML: nepreposielaj doň nedôveryhodné údaje. CSP alebo požiadavka na TrustedHTML môžu príklad zablokovať.

Prí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ýsledok

Ready

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje