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

CKTIS / JavaScript

HTMLIFrameElement: contentWindow и събитието load

HTMLIFrameElement представя вграден рамков прозорец. Свойството contentWindow предоставя достъп до прозореца му, а load позволява да реагирате при завършване на зареждането. Достъпът до документа зависи от правилото за един и същ произход, а load сам по себе си не потвърждава успешно извличане.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

iframe.contentWindow
iframe.addEventListener("load", handler);
iframe.srcdoc = trustedMarkup;

HTMLIFrameElement е DOM интерфейсът за елемент iframe, а не функция на езика ECMAScript. „Iframe contentWindow and load“ съчетава достъпа до прозореца на рамката с обработването на зареждането ѝ. Това е API на браузъра; наличието на Node 24 не доказва, че API е достъпно. Основният интерфейс и contentWindow се поддържат широко, но съвместимостта на допълнителните свойства трябва да се провери отделно.

Свойството contentWindow, което е само за четене, предоставя прозореца на вградения контекст чрез WindowProxy. Правилото за един и същ произход ограничава достъпа: четенето на contentWindow.document е позволено при рамка със същия произход, но при рамка с различен произход предизвиква изключение. За комуникация между прозорци с различен произход използвайте postMessage и проверявайте очакваните стойности на event.origin и event.source при получателя.

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

Примерът задава фиксиран документ чрез srcdoc, прочита текста му след load и премахва рамката. Без ограничения sandbox този документ е със същия произход като родителския. srcdoc интерпретира HTML: не му подавайте недоверени данни. CSP или изискване за TrustedHTML може да блокира примера.

Примери

const iframe = document.createElement("iframe");
iframe.title = "Demo";
iframe.addEventListener("load", () => {
  const childWindow = iframe.contentWindow;
  console.log(childWindow.document.querySelector("p").textContent);
  iframe.remove();
}, { once: true });
iframe.srcdoc = '<!doctype html><html lang="en"><title>Demo</title><body><p>Ready</p></body></html>';
document.body.append(iframe);

Резултат

Ready

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници