Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje