CKTIS / JavaScript
Zdarzenia DOMContentLoaded i pagehide
Używaj `DOMContentLoaded` do inicjalizacji po zbudowaniu DOM, a `pagehide` do wstrzymania pracy przy opuszczaniu strony. Powrót z pamięci bfcache nie jest nowym wczytaniem.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);DOMContentLoaded to zdarzenie typu Event wywoływane na document po zakończeniu parsowania HTML, wykonaniu klasycznych skryptów z defer i rozpoczęciu ewaluacji skryptów modułowych bez async zaplanowanych na koniec parsowania. Zdarzenie nie czeka na zakończenie ewaluacji modułów: jeśli zależność wstrzyma wykonanie na await na najwyższym poziomie, DOMContentLoaded może wystąpić jeszcze przed rozpoczęciem wykonywania kodu modułu, który ją importuje. Nie czeka na obrazy, ramki ani zakończenie skryptów async. Arkusze stylów mogą opóźnić je pośrednio, blokując wykonanie skryptów. Do oczekiwania na zasoby, które opóźniają wczytanie strony, służy load na window.
Jeśli kod inicjalizacyjny może zostać uruchomiony późno, sprawdź document.readyState: przy "loading" zarejestruj jednorazowy listener DOMContentLoaded, a w przeciwnym razie użyj istniejącego już DOM. Stan "interactive" oznacza koniec parsowania, ale nie dowodzi, że zdarzenie już wystąpiło ani że inne skrypty zakończyły inicjalizację. Jeśli zależysz od takiego skryptu, jawnie ustal kolejność inicjalizacji.
pagehide to PageTransitionEvent obsługiwane na window przy opuszczaniu dokumentu, np. podczas nawigacji Wstecz. Nie jest sygnałem zwykłego przełączenia karty i nie pozwala anulować nawigacji. event.persisted === true oznacza, że dokument może zostać zachowany w pamięci nawigacji wstecz i w przód (bfcache), ale nie gwarantuje powrotu do niego. false oznacza, że dokument nie jest zachowywany na potrzeby tej nawigacji. Wstrzymaj pracę przy pagehide i wznów ją przy pageshow z persisted === true: odzyskany dokument zachowuje swój DOM, a DOMContentLoaded nie jest wywoływane ponownie.
Zapisuj ważne dane na bieżąco: pagehide może nie wystąpić, zwłaszcza po wymuszonym zamknięciu przeglądarki mobilnej, a rozpoczęte operacje asynchroniczne mogą się nie zakończyć. Do reagowania na ukrycie strony użyj visibilitychange na document i sprawdzaj stan "hidden". Są to interfejsy platformy WWW, a nie funkcje dodane w ECMAScript 2024.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOMContentLoaded and pagehide</title>
<script>
(() => {
const init = () => console.log("DOM ready");
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
window.addEventListener("pagehide", (event) => {
console.log(`pagehide persisted=${event.persisted}`);
});
window.addEventListener("pageshow", (event) => {
if (event.persisted) console.log("pageshow restored");
});
})();
</script>
</head>
<body>
<p>Open the browser console to see the event log.</p>
</body>
</html>Wynik
DOM ready
Zapisz przykład jako plik HTML i otwórz go w przeglądarce. Włącz zachowywanie logu w konsoli i odśwież stronę. `DOM ready` pojawi się po wywołaniu `DOMContentLoaded`. Kolejne komunikaty zależą od nawigacji i decyzji przeglądarki o zachowaniu dokumentu.
Powiązane lekcje
- JavaScript · Lekcja 40 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 41 · Zaawansowany · Wersja: 4