Kaip veikia pareikalavimo principu atliekama revalidacija (ISR)?

Question

Accepted Answer

**Pareikalavimo principu atliekama revalidacija** leidžia jums unieiginti cache/statinius puslapius **tiksliai tada, kai pasikeitė duomenys** — o ne laukiant laiko intervalo. Tai tikslus laiku pagrįstos ISR (`revalidate: N`) papildas.

## Laiku pagrįsta vs pareikalavimo principu

```tsx
// Time-based: page refreshes on a fixed schedule (may serve stale data up to N seconds)
export const revalidate = 3600; // every hour

// On-demand: refresh the INSTANT the underlying data changes — no waiting, no waste
```

Laiku pagrįsta ISR yra paprasta, bet neideali: per trumpa = nereikalinga regeneracija; per ilga = pasenusi turinys. Pareikalavimo principu atliekama revalidacija tai išsprendžia suaktyvinant revalidaciją iš jūsų kodo, kai iš tikrųjų atsiranda pokyčiai.

## Du pareikalavimo principu atliekami API

```tsx
import { revalidatePath, revalidateTag } from "next/cache";

// 1. Tag your fetches, then invalidate by tag
await fetch("https://api/posts", { next: { tags: ["posts"] } });
revalidateTag("posts");      // refresh EVERY page/fetch tagged "posts"

// 2. Or invalidate a specific path
revalidatePath("/blog/my-post");
```

## Realus darbo srautas: CMS webhook

```ts
// app/api/revalidate/route.ts — called by your CMS when an editor publishes
import { revalidateTag } from "next/cache";
import { NextRequest, NextResponse } from "next/server";

export async function POST(req: NextRequest) {
  const secret = req.nextUrl.searchParams.get("secret");
  if (secret !== process.env.REVALIDATE_SECRET) {       // verify it's really your CMS
    return NextResponse.json({ ok: false }, { status: 401 });
  }
  revalidateTag("posts");                                // rebuild affected pages now
  return NextResponse.json({ revalidated: true });
}
```

Srautas: redaktorius publikuoja CMS → CMS iškviečia jūsų webhook → `revalidateTag("posts")` unieigina cache → kitas lankytoja gauna iš naujo sugeneruotą statinį HTML. Puslapiai lieka statiškai greitų **ir** atnaujinami nedelsiant publikavus.

## Po Server Action mutacijos

```tsx
"use server";
export async function createPost(data) {
  await db.post.create({ data });
  revalidateTag("posts"); // user sees their new post immediately
}
```

## Kodėl tai svarbu

Pareikalavimo principu atliekama revalidacija suteikia jums šventąjį grąžlį: **statinį greitį su real-time aktualumu**.

Vietoj to, kad atspėtumėte revalidacijos intervalą, jūs unieiginate tiksliai tada, kai pasikeičia turinys — per webhook'us (CMS publikavimas) arba po Server Action mutacijų — naudodami `revalidateTag`/`revalidatePath`.

Ji pašalina pasenusį turinį ir neveltui atliekamą per dažną regeneraciją, todėl ISR praktika naudingesnė turiniui, kuris atnaujinamas neperspektyviai.