revalidateTag

Mit revalidateTag können Sie zwischengespeicherte Daten bei Bedarf für einen bestimmten Cache-Tag ungültig machen.

Wissenswert:

• revalidateTag macht den Cache nur ungültig, wenn der Pfad das nächste Mal aufgerufen wird. Das bedeutet, dass der Aufruf von revalidateTag mit einem dynamischen Routensegment nicht sofort viele Neuvalidierungen auslöst. Die Ungültigmachung erfolgt erst beim nächsten Aufruf des Pfads.

Parameter

revalidateTag(tag: string): void;

• tag: Eine Zeichenkette, die den Cache-Tag der Daten repräsentiert, die Sie neu validieren möchten. Muss 256 Zeichen oder weniger betragen. Die Groß-/Kleinschreibung wird beachtet.

Sie können Tags wie folgt zu fetch hinzufügen:

fetch(url, { next: { tags: [...] } });

Rückgabewert

revalidateTag gibt keinen Wert zurück.

Beispiele

Server-Aktion

'use server'

import { revalidateTag } from 'next/cache'

export default async function submit() {
  await addPost()
  revalidateTag('posts')
}

Route-Handler

import type { NextRequest } from 'next/server'
import { revalidateTag } from 'next/cache'

export async function GET(request: NextRequest) {
  const tag = request.nextUrl.searchParams.get('tag')
  revalidateTag(tag)
  return Response.json({ revalidated: true, now: Date.now() })
}