Gestionnaire de cache personnalisé pour Next.js
Vous pouvez configurer l'emplacement du cache Next.js si vous souhaitez persister les pages et données en cache dans un stockage durable, ou partager le cache entre plusieurs conteneurs ou instances de votre application Next.js.
Consultez un exemple de gestionnaire de cache personnalisé et apprenez-en plus sur son implémentation.
Référence API
Le gestionnaire de cache peut implémenter les méthodes suivantes : get
, set
, revalidateTag
et resetRequestCache
.
get()
Paramètre | Type | Description |
---|---|---|
key | string | La clé de la valeur en cache. |
Retourne la valeur en cache ou null
si non trouvée.
set()
Paramètre | Type | Description |
---|---|---|
key | string | La clé sous laquelle stocker les données. |
data | Data ou null | Les données à mettre en cache. |
ctx | { tags: [] } | Les étiquettes de cache fournies. |
Retourne Promise<void>
.
revalidateTag()
Paramètre | Type | Description |
---|---|---|
tag | string ou string[] | Les étiquettes de cache à revalider. |
Retourne Promise<void>
. Apprenez-en plus sur la revalidation des données ou la fonction revalidateTag()
.
resetRequestCache()
Cette méthode réinitialise le cache temporaire en mémoire pour une seule requête avant la prochaine requête.
Retourne void
.
Bon à savoir :
revalidatePath
est une couche de commodité au-dessus des étiquettes de cache. AppelerrevalidatePath
appellera votre fonctionrevalidateTag
, que vous pouvez ensuite choisir d'utiliser pour étiqueter les clés de cache en fonction du chemin.
Support des plateformes
Option de déploiement | Supporté |
---|---|
Serveur Node.js | Oui |
Conteneur Docker | Oui |
Export statique | Non |
Adaptateurs | Dépend de la plateforme |
Apprenez comment configurer ISR lors de l'hébergement autonome de Next.js.
Historique des versions
Version | Changements |
---|---|
v14.1.0 | Renommé en cacheHandler et devenu stable. |
v13.4.0 | Prise en charge de revalidateTag pour incrementalCacheHandlerPath . |
v13.4.0 | Prise en charge de la sortie autonome pour incrementalCacheHandlerPath . |
v12.2.0 | Ajout expérimental de incrementalCacheHandlerPath . |