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