Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

PageTransitionEvent.persisted — ohranjanje in obnavljanje dokumentov

PageTransitionEvent prenaša informacije o dogodkih pageshow in pagehide. Njegova lastnost persisted omogoča razlikovanje med obnovitvijo dokumenta in običajnim nalaganjem ter pove, ali namerava brskalnik dokument ohraniti za morebitno ponovno uporabo.

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

Sintaksa

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

PageTransitionEvent deduje od Event in je vrsta objekta dogodka za pageshow in pagehide, ki se obravnavata na window. Gre za vmesnik brskalniškega spletnega API-ja, določen v HTML, in ne za funkcijo določene izdaje ECMAScripta. Ne opisuje animacij prehodov CSS.

PageTransitionEvent.persisted je logična lastnost, ki je samo za branje. Pri pageshow vrednost true pomeni, da je bil obnovljen ohranjen dokument, običajno iz predpomnilnika nazaj/naprej (bfcache); false pomeni, da do take obnovitve ni prišlo. Ne preverja, ali je bil uporabljen predpomnilnik HTTP. Pri prvem nalaganju se pageshow zgodi po load.

Pri dogodku pagehide, ki ga sproži brskalnik, vrednost true pomeni, da namerava brskalnik dokument ohraniti za morebitno ponovno uporabo. To ne zagotavlja, da bo dokument shranjen v bfcache ali da bo pozneje obnovljen. V aplikaciji beri event.persisted v obravnavalnikih, registriranih z window.addEventListener("pageshow", handler) ali window.addEventListener("pagehide", handler). Veja za obnovitev lahko osveži podatke, ki so morda zastareli.

MDN navaja, da sta vmesnik in lastnost široko dostopna od julija 2015, konstruktor pa od januarja 2020. Podporo konstruktorja preveri posebej; Node 24 ne dokazuje razpoložljivosti tega brskalniškega API-ja. Primer ustvari dva sintetična dogodka in preveri samo vejitev: ne sproži navigacije ali uporabe bfcache.

Primeri

(() => {
  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));
  }
})();

Rezultat

not restored
restored

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri