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

CKTIS / JavaScript

iframe: vlastnosť contentWindow a udalosť load

`contentWindow` vracia odkaz na okno rámca. `load` oznamuje koniec pokusu o načítanie, ale nepotvrdzuje jeho úspech ani neudeľuje prístup k DOM.

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

Syntax

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

iframe.contentWindow je vlastnosť iba na čítanie. Vracia WindowProxy kontextu prehliadania rámca alebo null, ak rámec nemá kontext, napríklad po vytvorení pred vložením do dokumentu. Pri navigácii v tom istom kontexte zostáva proxy tým istým objektom, aj keď sa podkladové objekty Window a Document zmenia. Samotná existencia proxy neznamená, že je cieľový dokument pripravený.

Zaregistruj obsluhu udalosti load na prvku iframe, nie na jeho okne, ešte pred vložením rámca alebo začatím sledovanej navigácie. Pri neskoršej navigácii môže udalosť nastať znova; pri { once: true } sa obsluha odstráni tesne pred svojím prvým zavolaním. load môže nastať aj pri neúspešnom načítaní a prvok toto zlyhanie nehlási udalosťou error. Žiadna z týchto udalostí neudeľuje prístup ani nepotvrdzuje pripravenosť vloženej aplikácie.

iframe.contentWindow.document môžeš prečítať, ak majú dokument rámca a nadradená stránka rovnaký pôvod. Pri odlišnom pôvode tento prístup vyvolá SecurityError, kým iframe.contentDocument vráti null. sandbox bez allow-same-origin môže dokumentu priradiť nepriehľadný pôvod. Na komunikáciu so spolupracujúcim rámcom s iným známym pôvodom použi postMessage() s presným targetOrigin; príjemca má skontrolovať event.origin, event.source a štruktúru údajov správy.

Ide o API webovej platformy, nie o funkcie ECMAScriptu 2024. Príklad vyžaduje prehliadač s DOM; podpora a bezpečnostné pravidlá závisia od prostredia.

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

true
Frame ready

Ulož príklad ako súbor HTML, sprístupni ho cez HTTP(S) a otvor ho v prehliadači. Stránka musí povoľovať vložený skript, rámec aj priradenie do `srcdoc`. V konzole prehliadača sa pred vložením rámca vypíše `true` a v obsluhe `load` sa vypíše `Frame ready`. Príklad používa pevný dôveryhodný reťazec `srcdoc`, nenačítava externý dokument a po prečítaní titulku rámec odstráni.

Súvisiace lekcie

  • JavaScript · Lekcia 5 · Pokročilá · Verzia: 4

Zdroje