CKTIS / JavaScript
HTMLIFrameElement: contentWindow i zdarzenie load
HTMLIFrameElement reprezentuje osadzoną ramkę. Właściwość contentWindow udostępnia jej okno, a zdarzenie load pozwala reagować na zakończenie ładowania. Dostęp do dokumentu zależy od wspólnego pochodzenia, a samo load nie potwierdza sukcesu pobrania.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
iframe.contentWindow
iframe.addEventListener("load", handler);
iframe.srcdoc = trustedMarkup;HTMLIFrameElement to interfejs DOM elementu iframe, a nie funkcja języka ECMAScript. Temat „Iframe contentWindow and load” łączy dostęp do okna ramki z obsługą jej ładowania. To API przeglądarkowe; obecność Node 24 nie dowodzi jego dostępności. Podstawowy interfejs i contentWindow są szeroko obsługiwane, ale dodatkowe właściwości wymagają osobnego sprawdzenia zgodności.
Właściwość contentWindow jest tylko do odczytu i udostępnia okno osadzonego kontekstu poprzez WindowProxy. Zasada same-origin ogranicza dostęp: odczyt contentWindow.document jest dozwolony przy wspólnym pochodzeniu, natomiast dla innego pochodzenia zgłasza wyjątek. Do komunikacji między różnymi pochodzeniami używaj postMessage, sprawdzając po stronie odbiorcy oczekiwane event.origin i event.source.
Zarejestruj load na samej ramce przed rozpoczęciem ładowania lub dołączeniem jej do dokumentu. Zdarzenie nie bąbelkuje i nie można go anulować. Nie traktuj go jako dowodu poprawnego pobrania: ramki emitują load także przy niepowodzeniu ładowania i nie emitują odpowiadającego mu error. Opcja { once: true } obsłuży tylko pierwsze zdarzenie, nie kolejne nawigacje.
Przykład ustawia stały dokument przez srcdoc, odczytuje tekst po load i usuwa ramkę. Bez ograniczeń sandbox taki dokument ma wspólne pochodzenie z rodzicem. srcdoc interpretuje HTML: nie przekazuj do niego niezaufanych danych. Polityka CSP lub wymóg TrustedHTML mogą zablokować przykład.
Przykłady
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);Wynik
Ready
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.