CKTIS / JavaScript
PageTransitionEvent.persisted — Dokumente erhalten und wiederherstellen
PageTransitionEvent übermittelt Informationen zu pageshow- und pagehide-Ereignissen. Die Eigenschaft persisted unterscheidet die Wiederherstellung eines Dokuments vom gewöhnlichen Laden und zeigt an, ob der Browser das Dokument zur möglichen Wiederverwendung aufbewahren will.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.persisted
new PageTransitionEvent(type, { persisted: boolean })PageTransitionEvent erbt von Event und ist der Ereignisobjekttyp für pageshow und pagehide, die auf window behandelt werden. Es handelt sich um eine Browser-Web-API-Schnittstelle aus HTML, nicht um eine Funktion einer bestimmten ECMAScript-Ausgabe. Sie beschreibt keine CSS-Übergangsanimationen.
PageTransitionEvent.persisted ist eine schreibgeschützte boolesche Eigenschaft. Bei pageshow bedeutet true, dass ein erhaltenes Dokument wiederhergestellt wurde, typischerweise aus dem Back/Forward-Cache (bfcache); false bedeutet, dass keine solche Wiederherstellung stattgefunden hat. Damit wird nicht geprüft, ob der HTTP-Cache verwendet wurde. Beim ersten Laden tritt pageshow nach load auf.
Bei einem vom Browser ausgelösten pagehide-Ereignis bedeutet true, dass der Browser das Dokument zur möglichen Wiederverwendung aufbewahren will. Das garantiert weder, dass das Dokument in den bfcache aufgenommen wird, noch, dass es später wiederhergestellt wird. Lies in einer Anwendung event.persisted in Handlern aus, die mit window.addEventListener("pageshow", handler) oder window.addEventListener("pagehide", handler) registriert wurden. Im Wiederherstellungszweig lassen sich Daten aktualisieren, die möglicherweise veraltet sind.
MDN kennzeichnet die Schnittstelle und die Eigenschaft seit Juli 2015 als breit verfügbar, den Konstruktor seit Januar 2020. Prüfe die Unterstützung des Konstruktors separat; Node 24 belegt nicht die Verfügbarkeit dieser Browser-API. Das Beispiel erstellt zwei synthetische Ereignisse und prüft nur die Verzweigung: Es löst weder eine Navigation noch die Nutzung des bfcache aus.
Beispiele
(() => {
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));
}
})();Ergebnis
not restored restored
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.