CKTIS / JavaScript
PageTransitionEvent.persisted — zachovanie a obnovenie dokumentov
PageTransitionEvent prenáša informácie o udalostiach pageshow a pagehide. Jeho vlastnosť persisted umožňuje rozlíšiť obnovenie dokumentu od bežného načítania a ukazuje, či prehliadač plánuje dokument zachovať na možné opätovné použitie.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.persisted
new PageTransitionEvent(type, { persisted: boolean })PageTransitionEvent dedí od Event a je typom objektu udalosti pre pageshow a pagehide, ktoré sa obsluhujú na window. Ide o rozhranie webového API prehliadača definované v HTML, nie o funkciu konkrétneho vydania ECMAScriptu. Nepopisuje animácie prechodov CSS.
PageTransitionEvent.persisted je logická vlastnosť iba na čítanie. Pri pageshow znamená true, že sa obnovil zachovaný dokument, zvyčajne z vyrovnávacej pamäte späť/vpred (bfcache); false znamená, že k takému obnoveniu nedošlo. Netestuje, či sa použila vyrovnávacia pamäť HTTP. Pri prvom načítaní nastane pageshow po load.
Pri udalosti pagehide vyvolanej prehliadačom znamená true, že prehliadač plánuje dokument zachovať na možné opätovné použitie. Nezaručuje to, že sa dokument uloží do bfcache ani že sa neskôr obnoví. V aplikácii čítaj event.persisted v obslužných rutinách zaregistrovaných pomocou window.addEventListener("pageshow", handler) alebo window.addEventListener("pagehide", handler). Vetva obnovenia môže slúžiť na aktualizáciu údajov, ktoré mohli zastarať.
MDN uvádza, že rozhranie a vlastnosť sú široko dostupné od júla 2015 a konštruktor od januára 2020. Podporu konštruktora over osobitne; Node 24 nedokazuje dostupnosť tohto API prehliadača. Príklad vytvára dve syntetické udalosti a testuje iba vetvenie: nespúšťa navigáciu ani bfcache.
Príklady
(() => {
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));
}
})();Výsledok
not restored restored
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.