StaleTimes (experimental)

Warnung: Die staleTimes-Konfiguration ist ein experimentelles Feature. Diese Konfigurationsstrategie wird sich voraussichtlich in Zukunft ändern.

staleTimes ist ein experimentelles Feature, das die Konfiguration der Invalidierungsdauer des Client-Router-Caches ermöglicht.

Diese Konfigurationsoption ist ab Version v14.2.0-canary.53 verfügbar.

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 dynamic-Eigenschaft wird verwendet, wenn die Seite weder statisch generiert noch vollständig geprefetcht wurde (d.h. mit prefetch=).
  • Standardwert: 0 Sekunden (nicht gecached)
• Die static-Eigenschaft wird für statisch generierte Seiten verwendet oder wenn die prefetch-Prop auf Link auf true gesetzt ist oder wenn router.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 Seiten-Segment.
• Dies ändert nicht das Vorwärts/Rückwärts-Caching-Verhalten, um Layout-Shifts zu verhindern und die Browser-Scroll-Position beizubehalten.

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

Versionsverlauf