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.