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

CKTIS / JavaScript

iframe: vlastnost contentWindow a událost load

`contentWindow` vrací odkaz na okno rámce. `load` oznamuje konec pokusu o načtení, ale nepotvrzuje jeho úspěch ani neuděluje přístup k DOM.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const frameWindow = iframe.contentWindow;
iframe.addEventListener("load", handler);
iframe.addEventListener("load", handler, { once: true });

iframe.contentWindow je vlastnost pouze pro čtení. Vrací WindowProxy kontextu procházení rámce nebo null, pokud rámec žádný kontext nemá, například hned po vytvoření před vložením do dokumentu. Při navigaci uvnitř téhož kontextu zůstává proxy stejným objektem, i když se podkladové objekty Window a Document změní. Samotná existence proxy neznamená, že je cílový dokument připravený.

Zaregistruj obsluhu události load na elementu iframe, ne na jeho okně, ještě před vložením rámce nebo zahájením sledované navigace. Pozdější navigace může událost vyvolat znovu; s { once: true } se obsluha odebere těsně před svým prvním zavoláním. load může nastat i při neúspěšném načtení a element toto selhání nehlásí událostí error. Ani jedna z těchto událostí neuděluje přístup ani nepotvrzuje připravenost vložené aplikace.

iframe.contentWindow.document můžeš přečíst, pokud dokument rámce a nadřazená stránka mají stejný původ. Při odlišném původu tento přístup vyvolá SecurityError, zatímco iframe.contentDocument vrátí null. sandbox bez allow-same-origin může dokumentu přiřadit neprůhledný původ. Pro komunikaci se spolupracujícím rámcem s jiným známým původem použij postMessage() s přesným targetOrigin; příjemce má zkontrolovat event.origin, event.source a strukturu dat zprávy.

Jde o API webové platformy, nikoli o funkce ECMAScriptu 2024. Příklad vyžaduje prohlížeč s DOM; podpora a bezpečnostní zásady závisí na prostředí.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>iframe contentWindow and load</title>
</head>
<body>
  <script>
    (() => {
      const iframe = document.createElement("iframe");
      console.log(iframe.contentWindow === null);

      iframe.srcdoc = "<!doctype html><title>Frame ready</title>";
      iframe.addEventListener("load", () => {
        console.log(iframe.contentWindow.document.title);
        iframe.remove();
      }, { once: true });

      document.body.append(iframe);
    })();
  </script>
</body>
</html>

Výsledek

true
Frame ready

Ulož příklad jako soubor HTML, zpřístupni ho přes HTTP(S) a otevři ho v prohlížeči. Stránka musí povolovat vložený skript, rámec i přiřazení do `srcdoc`. V konzoli prohlížeče se před vložením rámce vypíše `true` a v obsluze `load` se vypíše `Frame ready`. Příklad používá pevný důvěryhodný řetězec `srcdoc`, nenačítá externí dokument a po přečtení titulku rámec odstraní.

Související lekce

  • JavaScript · Lekce 5 · Pokročilá · Verze: 4

Zdroje