CKTIS / JavaScript
PageTransitionEvent.persisted — conservar y restaurar documentos
PageTransitionEvent transmite información sobre los eventos pageshow y pagehide. Su propiedad persisted permite distinguir la restauración de un documento de una carga normal e indica si el navegador tiene intención de conservar el documento para una posible reutilización.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
event.persisted
new PageTransitionEvent(type, { persisted: boolean })PageTransitionEvent hereda de Event y es el tipo de objeto de evento para pageshow y pagehide, que se gestionan en window. Es una interfaz de la API web del navegador definida en HTML, no una función de una edición concreta de ECMAScript. No describe las animaciones de transición CSS.
PageTransitionEvent.persisted es una propiedad booleana de solo lectura. En pageshow, true significa que se restauró un documento conservado, normalmente desde la caché de navegación atrás/adelante (bfcache); false significa que no se produjo esa restauración. No comprueba si se utilizó la caché HTTP. En la carga inicial, pageshow ocurre después de load.
En un evento pagehide disparado por el navegador, true significa que el navegador tiene intención de conservar el documento para una posible reutilización. No garantiza que el documento se guarde en la bfcache ni que se restaure más adelante. En una aplicación, lee event.persisted en los controladores registrados mediante window.addEventListener("pageshow", handler) o window.addEventListener("pagehide", handler). La rama de restauración puede servir para actualizar datos que hayan quedado obsoletos.
MDN indica que la interfaz y la propiedad están ampliamente disponibles desde julio de 2015, y el constructor desde enero de 2020. Comprueba por separado la compatibilidad del constructor; Node 24 no demuestra que esta API del navegador esté disponible. El ejemplo crea dos eventos sintéticos y solo prueba la ramificación: no provoca navegación ni el uso de bfcache.
Ejemplos
(() => {
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));
}
})();Resultado
not restored restored
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.