CKTIS / JavaScript
DOMContentLoaded, pagehide i pageshow: gotowość DOM i nawigacja
Odróżnij gotowość DOM od opuszczenia strony i powrotu do niej. Dowiedz się, kiedy sprawdzać `readyState` oraz jak interpretować `persisted` w obu zdarzeniach nawigacyjnych.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);
// onPageHide and onPageShow receive a PageTransitionEvent with a boolean persisted property.DOMContentLoaded to zdarzenie przeglądarki typu Event. Nasłuchuj go na document: występuje po przetworzeniu HTML i wykonaniu odroczonych skryptów klasycznych (defer). Przed wywołaniem zdarzenia przeglądarka rozpoczyna też ewaluację skryptów modułowych bez async wstawionych przez parser. Nie czeka jednak na zakończenie operacji oczekiwanych przez await na najwyższym poziomie modułu lub jego zależności, więc inicjalizacja modułu może nadal trwać po wystąpieniu zdarzenia. Nie czeka na obrazy, ramki ani skrypty z async; arkusze stylów mogą je opóźnić pośrednio, blokując skrypty odroczone. To nie jest zdarzenie load.
Jeśli kod może uruchomić się późno i potrzebuje tylko przetworzonego DOM, sprawdź document.readyState. Dla "loading" dodaj jednorazowy nasłuch DOMContentLoaded; w przeciwnym razie zainicjuj od razu. Stan "interactive" oznacza, że HTML już przetworzono, ale nie dowodzi, że DOMContentLoaded już wystąpiło ani że inne skrypty zakończyły inicjalizację.
Na window nasłuchuj pagehide przy opuszczaniu dokumentu i pageshow przy jego wczytaniu lub przywróceniu. Oba to PageTransitionEvent z logicznym persisted. Dla pagehide wartość true oznacza możliwość ponownego użycia dokumentu, bez gwarancji; false oznacza, że nie zostanie ponownie użyty. Przy nowym wczytaniu pageshow następuje po load z false. Przy powrocie z pamięci podręcznej nawigacji wstecz i do przodu (bfcache) ma true: wracają ten sam DOM i stan JavaScript, bez ponownego DOMContentLoaded.
Użyj pagehide do wstrzymania pracy związanej ze stroną, a pageshow z persisted === true do jej wznowienia lub odświeżenia nieaktualnych danych. pagehide może nie wystąpić, np. po zamknięciu przeglądarki działającej w tle na telefonie. Zapisuj ważne zmiany na bieżąco; do wykrywania zmiany widoczności użyj visibilitychange i document.visibilityState. Te zdarzenia nie informują o zwykłym przełączeniu karty i należą do platformy webowej, nie do ECMAScript.
Przykłady
(() => {
function installListeners(doc, win) {
const onDomReady = () => console.log("DOM ready");
if (doc.readyState === "loading") {
doc.addEventListener("DOMContentLoaded", onDomReady, { once: true });
} else {
onDomReady();
}
const logTransition = (event) => {
console.log(`${event.type} persisted=${event.persisted}`);
};
win.addEventListener("pagehide", logTransition);
win.addEventListener("pageshow", logTransition);
}
if (typeof document !== "undefined" && typeof window !== "undefined") {
installListeners(document, window);
} else {
// Node.js test: simulate DOM readiness without simulating navigation.
const testDocument = new EventTarget();
const testWindow = new EventTarget();
testDocument.readyState = "loading";
installListeners(testDocument, testWindow);
testDocument.readyState = "interactive";
testDocument.dispatchEvent(new Event("DOMContentLoaded"));
}
})();Wynik
DOM ready
Wklej kod raz do konsoli przeglądarki po pełnym wczytaniu strony. `DOM ready` pochodzi wtedy ze sprawdzenia `readyState`, a nie z powtórzenia zdarzenia. Włącz zachowywanie logów, przejdź do innego dokumentu w tej samej karcie i wróć. Dodatkowe wpisy zależą od nawigacji i decyzji przeglądarki o użyciu bfcache.
Powiązane lekcje
- JavaScript · Lekcja 37 · Zaawansowany · Wersja: 4