CKTIS / JavaScript
Zdarzenia cyklu życia strony: widoczność, opuszczenie i powrót
Rozróżnij ukrycie karty, próbę opuszczenia strony i przywrócenie dokumentu z pamięci podręcznej, aby zapisywać stan i ostrzegać we właściwym momencie.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
document.addEventListener('visibilitychange', onVisibilityChange); // Read document.visibilityState or document.hidden.
window.addEventListener('beforeunload', onBeforeUnload); // Register only while unsaved changes exist.
window.removeEventListener('beforeunload', onBeforeUnload); // Remove the same listener once changes are saved or discarded.
window.addEventListener('pagehide', onPageHide); // Read event.persisted.
window.addEventListener('pageshow', onPageShow); // Read event.persisted.Te cztery zdarzenia należą do platformy webowej, a nie do ECMAScript 2024. Obsługa i zachowanie zależą od przeglądarki oraz sytuacji; nie zakładaj, że wszystkie zdarzenia wystąpią w ustalonej kolejności.
Nasłuchuj visibilitychange na document. Tego zdarzenia nie można anulować. Odczytaj document.visibilityState (visible albo hidden) lub wartość logiczną document.hidden. Przełączenie karty może ukryć stronę bez jej opuszczania. Zapisuj stan na bieżąco, a przejście do hidden traktuj jako najlepszy sygnał na ostatni zapis lub wstrzymanie pracy, nie jako gwarancję zakończenia sesji.
beforeunload na window to anulowalne zdarzenie typu BeforeUnloadEvent, związane z próbą opuszczenia strony, jej odświeżenia lub zamknięcia karty. Aby poprosić o potwierdzenie, wywołaj event.preventDefault() i dla zgodności ze starszymi przeglądarkami ustaw event.returnValue na niepusty ciąg. Sam zwrot wartości z funkcji działa tylko przez onbeforeunload, nie przez addEventListener(). Okno dialogowe wymaga wcześniejszej odpowiedniej interakcji użytkownika (sticky activation); przeglądarka może je pominąć i sama ustala jego tekst. Dodawaj nasłuch tylko przy niezapisanych zmianach i usuwaj go po zapisie lub odrzuceniu zmian: może on uniemożliwić użycie bfcache, między innymi w Firefoksie.
pagehide i pageshow to nieanulowalne zdarzenia typu PageTransitionEvent, których nasłuchuje się na window. Przy opuszczaniu dokumentu pagehide z event.persisted === true oznacza zamiar zachowania go w pamięci na potrzeby nawigacji wstecz/dalej (bfcache), a nie gwarancję przywrócenia. false oznacza brak takiego zamiaru. pagehide nadaje się do wstrzymania zasobów, nie do zapisu krytycznych danych: zarówno ono, jak i beforeunload mogą nie wystąpić, np. gdy system mobilny zakończy działanie przeglądarki w tle.
Przy pierwszym wczytaniu pageshow następuje po load i ma persisted === false. Wartość true oznacza, że ten sam dokument faktycznie przywrócono z bfcache: wznów wstrzymaną pracę i odśwież dane, które mogły się zdezaktualizować. pageshow nie oznacza, że użytkownik widzi stronę; może wystąpić także w karcie w tle.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Page lifecycle events</title>
</head>
<body>
<label><input id="dirty" type="checkbox" autocomplete="off"> Simulate unsaved changes</label>
<script>
const dirty = document.getElementById('dirty');
function warn(event) {
console.log('beforeunload');
event.preventDefault();
event.returnValue = 'unsaved'; // Legacy compatibility, not dialog text.
}
dirty.addEventListener('change', () => {
if (dirty.checked) {
window.addEventListener('beforeunload', warn);
} else {
window.removeEventListener('beforeunload', warn);
}
});
document.addEventListener('visibilitychange', () => {
console.log(`visibilitychange: ${document.visibilityState}`);
});
for (const type of ['pagehide', 'pageshow']) {
window.addEventListener(type, (event) => {
console.log(`${type}: persisted=${event.persisted}`);
});
}
console.log('ready');
</script>
</body>
</html>Wynik
ready Then, for example, after switching away from the tab and back: visibilitychange: hidden visibilitychange: visible Other lines (not guaranteed and not in a fixed cross-event order): beforeunload pagehide: persisted=true pageshow: persisted=true A dispatched page transition event can also report persisted=false.
Otwórz przykład jako stronę HTML w przeglądarce i sprawdź konsolę. `ready` pojawia się od razu; kolejne wpisy zależą od działań i przeglądarki. Pole wyboru symuluje niezapisane zmiany, ale niczego nie zapisuje.
Powiązane lekcje
- JavaScript · Lekcja 35 · Zaawansowany · Wersja: 4