CKTIS / JavaScript
Ramka iframe: właściwość contentWindow i zdarzenie load
`contentWindow` daje dostęp do obiektu reprezentującego okno ramki, a `load` powiadamia o zakończeniu ładowania. Zdarzenie nie potwierdza powodzenia ani nie daje dostępu do DOM.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
const frameWindow = iframe.contentWindow;
iframe.addEventListener("load", handler);
iframe.addEventListener("load", handler, { once: true });iframe.contentWindow to właściwość tylko do odczytu. Zwraca WindowProxy kontekstu przeglądania ramki albo null, jeśli ramka nie ma takiego kontekstu, na przykład przed wstawieniem nowego elementu do dokumentu. Przy nawigacji w tym samym kontekście obiekt WindowProxy zachowuje tożsamość, choć obiekty Window i Document, do których prowadzi, mogą się zmienić. Sama obecność obiektu proxy nie oznacza, że docelowy dokument jest gotowy.
Zarejestruj funkcję obsługi load na elemencie iframe, a nie na jego oknie, przed wstawieniem ramki lub rozpoczęciem nawigacji, którą chcesz obserwować. Późniejsza nawigacja może ponownie wywołać zdarzenie; przy { once: true } funkcja obsługi jest usuwana tuż przed jej pierwszym wywołaniem. load może wystąpić także po nieudanym ładowaniu, a error na elemencie nie sygnalizuje takiej awarii. Żadne z tych zdarzeń nie nadaje uprawnień ani nie potwierdza gotowości aplikacji.
Możesz odczytać iframe.contentWindow.document, gdy dokument ramki ma to samo źródło (origin) co strona nadrzędna. Przy różnych źródłach odczyt zgłasza SecurityError, a iframe.contentDocument zwraca null. Atrybut sandbox bez allow-same-origin może nadać dokumentowi nieprzezroczyste źródło. Do komunikacji ze współpracującą ramką o innym, znanym źródle użyj postMessage() z dokładnym targetOrigin; odbiorca powinien sprawdzić event.origin, event.source i strukturę danych wiadomości.
To API platformy WWW, a nie funkcja ECMAScript 2024. Przykład wymaga przeglądarki z DOM; obsługa i zasady bezpieczeństwa zależą od środowiska.
Przykłady
<!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>Wynik
true Frame ready
Zapisz przykład jako plik HTML, udostępnij go przez HTTP(S) i otwórz w przeglądarce. Zasady strony muszą zezwalać na skrypt osadzony w HTML, ramkę i użycie `srcdoc`. W konsoli przeglądarki `true` pojawia się przed wstawieniem ramki, a `Frame ready` w funkcji obsługi `load`. Przykład korzysta ze stałego, zaufanego tekstu `srcdoc`, nie pobiera zewnętrznego dokumentu i usuwa ramkę po odczytaniu tytułu.
Powiązane lekcje
- JavaScript · Lekcja 5 · Zaawansowany · Wersja: 4