CKTIS / JavaScript
PageTransitionEvent.persisted — zachowanie i przywracanie dokumentu
PageTransitionEvent przenosi informacje o zdarzeniach pageshow i pagehide. Jego właściwość persisted pozwala odróżnić przywrócenie dokumentu od zwykłego wczytania oraz wskazuje, czy przeglądarka zamierza zachować dokument do ewentualnego ponownego użycia.
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
event.persisted
new PageTransitionEvent(type, { persisted: boolean })PageTransitionEvent dziedziczy po Event i jest typem obiektu zdarzeń pageshow oraz pagehide obsługiwanych na window. To interfejs przeglądarkowego Web API zdefiniowany w HTML, a nie funkcja konkretnej edycji ECMAScript. Nie opisuje animacji przejść CSS.
PageTransitionEvent.persisted jest właściwością logiczną tylko do odczytu. Dla pageshow wartość true oznacza przywrócenie zachowanego dokumentu, zwykle z pamięci wstecz/dalej (bfcache); false oznacza brak takiego przywrócenia. Nie jest to test użycia pamięci podręcznej HTTP. Przy pierwszym wczytaniu pageshow występuje po load.
W zdarzeniu pagehide wywołanym przez przeglądarkę wartość true oznacza, że przeglądarka zamierza zachować dokument do ewentualnego ponownego użycia. Nie gwarantuje to, że dokument trafi do bfcache ani że zostanie później przywrócony. W aplikacji odczytuj event.persisted w procedurach zarejestrowanych przez window.addEventListener("pageshow", handler) lub window.addEventListener("pagehide", handler). Gałąź przywrócenia może służyć do odświeżenia danych, które zdążyły się zdezaktualizować.
MDN oznacza interfejs i właściwość jako szeroko dostępne od lipca 2015, a konstruktor od stycznia 2020. Obsługę konstruktora sprawdzaj osobno; Node 24 nie potwierdza dostępności tego API przeglądarkowego. Przykład tworzy dwa syntetyczne zdarzenia i sprawdza wyłącznie rozgałęzienie: nie uruchamia nawigacji ani bfcache.
Przykłady
(() => {
function describePageShow(event) {
return event.persisted ? "restored" : "not restored";
}
for (const persisted of [false, true]) {
const event = new PageTransitionEvent("pageshow", { persisted });
console.log(describePageShow(event));
}
})();Wynik
not restored restored
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.