Benutzerdefinierter Next.js Cache-Handler
Sie können den Speicherort des Next.js-Caches konfigurieren, wenn Sie zwischengespeicherte Seiten und Daten in einem dauerhaften Speicher persistieren oder den Cache über mehrere Container oder Instanzen Ihrer Next.js-Anwendung hinweg teilen möchten.
Sehen Sie sich ein Beispiel für einen benutzerdefinierten Cache-Handler an und erfahren Sie mehr über die Implementierung.
API-Referenz
Der Cache-Handler kann die folgenden Methoden implementieren: get
, set
, revalidateTag
und resetRequestCache
.
get()
Parameter | Typ | Beschreibung |
---|---|---|
key | string | Der Schlüssel zum zwischengespeicherten Wert. |
Gibt den zwischengespeicherten Wert oder null
zurück, falls nicht gefunden.
set()
Parameter | Typ | Beschreibung |
---|---|---|
key | string | Der Schlüssel, unter dem die Daten gespeichert werden. |
data | Data oder null | Die zu cachenden Daten. |
ctx | { tags: [] } | Die bereitgestellten Cache-Tags. |
Gibt Promise<void>
zurück.
revalidateTag()
Parameter | Typ | Beschreibung |
---|---|---|
tag | string oder string[] | Die zu revalidierenden Cache-Tags. |
Gibt Promise<void>
zurück. Erfahren Sie mehr über das Revalidieren von Daten oder die Funktion revalidateTag()
.
resetRequestCache()
Diese Methode setzt den temporären In-Memory-Cache für eine einzelne Anfrage vor der nächsten Anfrage zurück.
Gibt void
zurück.
Wissenswertes:
revalidatePath
ist eine bequeme Abstraktionsebene über Cache-Tags. Der Aufruf vonrevalidatePath
ruft IhrerevalidateTag
-Funktion auf, und Sie können dann entscheiden, ob Sie Cache-Schlüssel basierend auf dem Pfad taggen möchten.
Plattformunterstützung
Bereitstellungsoption | Unterstützt |
---|---|
Node.js-Server | Ja |
Docker-Container | Ja |
Statischer Export | Nein |
Adapter | Plattformspezifisch |
Erfahren Sie, wie Sie ISR konfigurieren, wenn Sie Next.js selbst hosten.
Versionsverlauf
Version | Änderungen |
---|---|
v14.1.0 | Umbenannt in cacheHandler und wurde stabil. |
v13.4.0 | incrementalCacheHandlerPath -Unterstützung für revalidateTag . |
v13.4.0 | incrementalCacheHandlerPath -Unterstützung für Standalone-Ausgabe. |
v12.2.0 | Experimentelle incrementalCacheHandlerPath hinzugefügt. |