CKTIS / JavaScript
PageTransitionEvent.persisted — conservation et restauration des documents
PageTransitionEvent transmet des informations sur les événements pageshow et pagehide. Sa propriété persisted permet de distinguer la restauration d’un document d’un chargement ordinaire et indique si le navigateur prévoit de conserver le document en vue d’une éventuelle réutilisation.
Version : 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 hérite de Event et désigne le type d’objet événement pour pageshow et pagehide, gérés sur window. C’est une interface d’API Web du navigateur définie dans HTML, et non une fonctionnalité d’une édition particulière d’ECMAScript. Elle ne décrit pas les animations de transition CSS.
PageTransitionEvent.persisted est une propriété booléenne en lecture seule. Pour pageshow, true signifie qu’un document conservé a été restauré, généralement depuis le cache de navigation arrière/avant (bfcache) ; false signifie qu’une telle restauration n’a pas eu lieu. Cette propriété ne vérifie pas si le cache HTTP a été utilisé. Lors du chargement initial, pageshow survient après load.
Lors d’un événement pagehide déclenché par le navigateur, true signifie que le navigateur prévoit de conserver le document en vue d’une éventuelle réutilisation. Cela ne garantit ni que le document sera placé dans le bfcache ni qu’il sera restauré par la suite. Dans une application, lis event.persisted dans des gestionnaires enregistrés avec window.addEventListener("pageshow", handler) ou window.addEventListener("pagehide", handler). La branche de restauration peut servir à actualiser des données qui ont pu devenir obsolètes.
MDN indique que l’interface et la propriété sont largement disponibles depuis juillet 2015, et le constructeur depuis janvier 2020. Vérifie séparément la prise en charge du constructeur ; Node 24 ne prouve pas la disponibilité de cette API de navigateur. L’exemple crée deux événements synthétiques et teste uniquement la branche conditionnelle : il ne déclenche ni navigation ni bfcache.
Exemples
(() => {
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));
}
})();Résultat
not restored restored
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.