staleTimes
staleTimes
ist ein experimentelles Feature, das die Zwischenspeicherung von Seitensegmenten im Client-seitigen Router-Cache ermöglicht.
Sie können dieses experimentelle Feature aktivieren und benutzerdefinierte Revalidierungszeiten festlegen, indem Sie das experimentelle staleTimes
-Flag setzen:
/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
staleTimes: {
dynamic: 30,
static: 180,
},
},
}
module.exports = nextConfig
Die Eigenschaften static
und dynamic
entsprechen dem Zeitraum (in Sekunden) basierend auf verschiedenen Arten von Link-Prefetching.
- Die Eigenschaft
dynamic
wird verwendet, wenn die Seite weder statisch generiert noch vollständig geprefetcht wurde (z.B. mitprefetch={true}
).- Standardwert: 0 Sekunden (nicht zwischengespeichert)
- Die Eigenschaft
static
wird für statisch generierte Seiten verwendet oder wenn dieprefetch
-Prop beiLink
auftrue
gesetzt ist oder wennrouter.prefetch
aufgerufen wird.- Standardwert: 5 Minuten
Gut zu wissen:
- Loading Boundaries gelten für den in dieser Konfiguration definierten
static
-Zeitraum als wiederverwendbar.- Dies beeinflusst nicht das Partielle Rendering, was bedeutet, dass gemeinsame Layouts nicht bei jeder Navigation automatisch neu abgerufen werden, sondern nur das sich ändernde Seitensegment.
- Dies ändert nicht das Verhalten des Vorwärts/Rückwärts-Caches, um Layout-Shifts zu verhindern und die Browser-Scrollposition beizubehalten.
Weitere Informationen zum Client-Router-Cache finden Sie hier.
Versionsverlauf
Version | Änderungen |
---|---|
v15.0.0 | Der Standardwert für dynamic staleTimes wurde von 30s auf 0s geändert. |
v14.2.0 | Experimentelles staleTimes eingeführt. |