Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

PageTransitionEvent.persisted — zachování a obnovení dokumentů

PageTransitionEvent předává informace o událostech pageshow a pagehide. Jeho vlastnost persisted umožňuje rozlišit obnovení dokumentu od běžného načtení a ukazuje, zda prohlížeč hodlá dokument zachovat pro možné opětovné použití.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

event.persisted
new PageTransitionEvent(type, { persisted: boolean })

PageTransitionEvent dědí z Event a je typem objektu události pro pageshow a pagehide, které se obsluhují na window. Jde o rozhraní webového API prohlížeče definované v HTML, nikoli o funkci konkrétní edice ECMAScriptu. Nepopisuje animace přechodů CSS.

PageTransitionEvent.persisted je logická vlastnost pouze pro čtení. U pageshow znamená true, že byl obnoven zachovaný dokument, obvykle z mezipaměti zpět/vpřed (bfcache); false znamená, že k takovému obnovení nedošlo. Neověřuje, zda byla použita mezipaměť HTTP. Při prvním načtení nastane pageshow po load.

U události pagehide vyvolané prohlížečem znamená true, že prohlížeč hodlá dokument zachovat pro možné opětovné použití. Nezaručuje to, že se dokument uloží do bfcache ani že bude později obnoven. V aplikaci čti event.persisted v obslužných rutinách zaregistrovaných pomocí window.addEventListener("pageshow", handler) nebo window.addEventListener("pagehide", handler). Větev obnovení může sloužit k aktualizaci dat, která mohla zastarat.

MDN uvádí, že rozhraní a vlastnost jsou široce dostupné od července 2015 a konstruktor od ledna 2020. Podporu konstruktoru ověř samostatně; Node 24 nedokládá dostupnost tohoto API prohlížeče. Příklad vytváří dvě syntetické události a testuje pouze větvení: nespouští navigaci ani bfcache.

Pří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ýsledek

not restored
restored

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje