CKTIS / JavaScript
PageTransitionEvent.persisted — conservazione e ripristino dei documenti
PageTransitionEvent trasporta informazioni sugli eventi pageshow e pagehide. La proprietà persisted consente di distinguere il ripristino di un documento da un normale caricamento e indica se il browser intende conservare il documento per un possibile riutilizzo.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
event.persisted
new PageTransitionEvent(type, { persisted: boolean })PageTransitionEvent eredita da Event ed è il tipo di oggetto evento per pageshow e pagehide, gestiti su window. È un’interfaccia della Web API del browser definita in HTML, non una funzionalità di una specifica edizione di ECMAScript. Non descrive le animazioni di transizione CSS.
PageTransitionEvent.persisted è una proprietà booleana di sola lettura. Per pageshow, true significa che è stato ripristinato un documento conservato, in genere dalla cache indietro/avanti (bfcache); false significa che non è avvenuto un ripristino del genere. Non verifica se è stata usata la cache HTTP. Al caricamento iniziale, pageshow si verifica dopo load.
In un evento pagehide generato dal browser, true significa che il browser intende conservare il documento per un possibile riutilizzo. Non garantisce che il documento venga inserito nella bfcache né che venga ripristinato in seguito. In un’applicazione, leggi event.persisted nei gestori registrati con window.addEventListener("pageshow", handler) o window.addEventListener("pagehide", handler). Il ramo di ripristino può essere usato per aggiornare dati che potrebbero essere diventati obsoleti.
MDN indica che l’interfaccia e la proprietà sono ampiamente disponibili da luglio 2015 e il costruttore da gennaio 2020. Verifica separatamente il supporto del costruttore; Node 24 non dimostra la disponibilità di questa API del browser. L’esempio crea due eventi sintetici e verifica solo la diramazione: non avvia una navigazione né il bfcache.
Esempi
(() => {
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));
}
})();Risultato
not restored restored
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.