Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła