Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

PageTransitionEvent.persisted — očuvanje i obnavljanje dokumenata

PageTransitionEvent prenosi informacije o događajima pageshow i pagehide. Njegovo svojstvo persisted omogućuje razlikovanje obnove dokumenta od uobičajenog učitavanja te pokazuje namjerava li preglednik sačuvati dokument za moguću ponovnu uporabu.

Verzija: 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 nasljeđuje od Event i vrsta je objekta događaja za pageshow i pagehide, koji se obrađuju na window. Riječ je o sučelju pregledničkog web API-ja definiranom u HTML-u, a ne o značajci određenog izdanja ECMAScripta. Ne opisuje CSS animacije prijelaza.

PageTransitionEvent.persisted logičko je svojstvo samo za čitanje. Za pageshow, true znači da je očuvan dokument obnovljen, obično iz predmemorije natrag/naprijed (bfcache); false znači da do takve obnove nije došlo. Ne provjerava je li upotrijebljena HTTP predmemorija. Pri prvom učitavanju pageshow nastupa nakon load.

U događaju pagehide koji pokrene preglednik vrijednost true znači da preglednik namjerava sačuvati dokument za moguću ponovnu uporabu. To ne jamči da će dokument biti pohranjen u bfcache ni da će kasnije biti obnovljen. U aplikaciji čitaj event.persisted u obrađivačima registriranima putem window.addEventListener("pageshow", handler) ili window.addEventListener("pagehide", handler). Grana za obnovu može poslužiti za osvježavanje podataka koji su možda zastarjeli.

MDN navodi da su sučelje i svojstvo široko dostupni od srpnja 2015., a konstruktor od siječnja 2020. Podršku konstruktora provjeri zasebno; Node 24 ne potvrđuje dostupnost ovog API-ja preglednika. Primjer stvara dva sintetička događaja i provjerava samo grananje: ne pokreće navigaciju ni bfcache.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori