База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

iframe: свойството contentWindow и събитието load

`contentWindow` дава препратка към прозореца на рамката. `load` показва края на опит за зареждане, но не потвърждава успех и не предоставя достъп до DOM.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

iframe.contentWindow е свойство само за четене. То връща WindowProxy на контекста за преглеждане на рамката или null, ако такъв контекст няма, например при току-що създадена рамка, преди да бъде добавена към документа. При навигация в същия контекст proxy обектът остава същият, дори когато обектите Window и Document, до които води, се сменят. Наличието му не означава, че желаният документ е готов.

Регистрирай обработчика на load върху елемента iframe, а не върху неговия прозорец, преди да добавиш елемента или да започнеш навигацията, която искаш да проследиш. Следваща навигация може отново да предизвика събитието; при { once: true } обработчикът се премахва непосредствено преди първото му извикване. load може да възникне и при неуспешно зареждане, а елементът не съобщава за този неуспех чрез error. Нито едно от тези събития не дава достъп и не потвърждава, че вграденото приложение е готово.

Можеш да прочетеш iframe.contentWindow.document, когато документът в рамката и родителската страница имат един и същ произход. При различни произходи достъпът предизвиква SecurityError, докато iframe.contentDocument връща null. sandbox без allow-same-origin може да зададе непрозрачен произход на документа. За обмен на съобщения с рамка, която участва в обмена и има друг известен произход, използвай postMessage() с точен targetOrigin; получателят трябва да проверява event.origin, event.source и структурата на данните в съобщението.

Това са API на уеб платформата, а не възможности на ECMAScript 2024. Примерът изисква браузър с DOM; поддръжката и правилата за сигурност зависят от средата.

Примери

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

Резултат

true
Frame ready

Запази примера като HTML файл, направи го достъпен през HTTP(S) и го отвори в браузър. Страницата трябва да допуска вградения скрипт, рамката и задаването на `srcdoc`. В конзолата на браузъра преди добавянето на рамката се извежда `true`, а в обработчика на `load` — `Frame ready`. Кодът използва фиксиран, доверен низ `srcdoc`, не зарежда външен документ и премахва рамката, след като прочете заглавието.

Свързани уроци

  • JavaScript · Урок 5 · Напреднало · Версия: 4

Източници