Menu

staleTimes

staleTimes ist ein experimentelles Feature, das das Caching von Pagesegmenten im clientseitigen Router-Cache ermöglicht.

Sie können dieses experimentelle Feature aktivieren und benutzerdefinierte Revalidierungszeiten festlegen, indem Sie das experimentelle staleTimes-Flag setzen:

next.config.js
/** @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 des Link-Prefetchings.

  • Die dynamic-Eigenschaft wird verwendet, wenn die Seite weder statisch generiert noch vollständig prefetcht ist (d.h. mit prefetch=).
    • Standard: 0 Sekunden (nicht gecacht)
  • Die static-Eigenschaft wird für statisch generierte Seiten verwendet oder wenn die prefetch-Eigenschaft von Link auf true gesetzt ist oder beim Aufruf von router.prefetch.
    • Standard: 5 Minuten

Hinweis:

  • Ladeabschnitte gelten für den in dieser Konfiguration definierten static-Zeitraum als wiederverwendbar.
  • Dies beeinflusst nicht das partielle Rendering, was bedeutet, dass gemeinsame Layouts bei jeder Navigation nicht automatisch erneut abgerufen werden, sondern nur das sich ändernde Pagesegment.
  • Dies ändert nicht das Verhalten des Vor-/Zurück-Cachings, um Layoutverschiebungen und Verlust der Browser-Scroll-Position zu verhindern.

Weitere Informationen zum Client-Router-Cache finden Sie hier.

Versionshistorie

VersionÄnderungen
v15.0.0Der dynamic staleTimes-Standardwert wurde von 30s auf 0s geändert.
v14.2.0Experimentelles staleTimes eingeführt.