Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

iframe: svojstvo contentWindow i događaj load

`contentWindow` daje referencu na prozor okvira. `load` označava kraj pokušaja učitavanja, ali ne potvrđuje uspjeh niti daje pristup DOM-u.

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

Sintaksa

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

iframe.contentWindow svojstvo je samo za čitanje. Vraća WindowProxy konteksta pregledavanja okvira ili null ako kontekst ne postoji, primjerice kad je okvir stvoren, ali još nije umetnut u dokument. Pri navigacijama unutar istog konteksta proxy zadržava identitet i kad se promijene objekti Window i Document na koje upućuje. Postojanje proxyja ne znači da je željeni dokument spreman.

Registriraj slušatelj za load na elementu iframe, a ne na njegovu prozoru, prije umetanja elementa ili pokretanja navigacije koju želiš pratiti. Kasnija navigacija može ponovno pokrenuti događaj; uz { once: true } slušatelj se uklanja neposredno prije prvog poziva. load se može dogoditi i kad učitavanje ne uspije, a element taj neuspjeh ne prijavljuje događajem error. Nijedan od tih događaja ne daje pristup niti potvrđuje da je ugrađena aplikacija spremna.

iframe.contentWindow.document možeš čitati ako dokument okvira i nadređena stranica imaju isto podrijetlo. Ako se podrijetla razlikuju, pristup izaziva SecurityError, dok iframe.contentDocument vraća null. sandbox bez allow-same-origin može dokumentu dodijeliti neprozirno podrijetlo. Za komunikaciju s okvirom koji surađuje i ima drugo poznato podrijetlo koristi postMessage() s točnim targetOrigin; primatelj treba provjeriti event.origin, event.source i strukturu podataka poruke.

To su API-ji web-platforme, a ne značajke ECMAScripta 2024. Primjer zahtijeva preglednik s DOM-om; podrška i sigurnosna pravila ovise o okruženju.

Primjeri

<!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>

Rezultat

true
Frame ready

Spremi primjer kao HTML datoteku, posluži je preko HTTP(S)-a i otvori je u pregledniku. Stranica mora dopuštati umetnutu skriptu, okvir i dodjelu vrijednosti svojstvu `srcdoc`. U konzoli preglednika prije umetanja okvira ispisuje se `true`, a u rukovatelju događajem `load` ispisuje se `Frame ready`. Primjer koristi fiksni, pouzdani niz `srcdoc`, ne učitava vanjski dokument i uklanja okvir nakon čitanja naslova.

Povezane lekcije

  • JavaScript · Lekcija 5 · Napredno · Verzija: 4

Izvori