Cache per fetch, revalidasi on-demand dengan revalidatePath, revalidateTag, dan updateTag, serta model Cache Components di Next.js 16.
18m bacaanKuis WajibMicro Badge Lesson
Revalidasi dan cache data
ISR berbasis waktu punya satu kelemahan: kalau admin memperbaiki salah ketik di sebuah course, perubahan itu baru muncul setelah waktu revalidasi lewat. Lesson ini membahas dua hal: cache untuk data di server, dan cara memperbarui cache tepat saat data berubah.
Cache per fetch
Selain di level route, kamu bisa mengatur cache untuk setiap fetch di Server Component:
tsx
const
res
=
await
fetch
(
"https://api.contoh.com/courses"
, {
next: { revalidate: 300, tags: ["courses"] },
});
revalidate: 300: hasil fetch disimpan dan dipakai ulang selama 300 detik.
tags: ["courses"]: memberi label pada cache ini, supaya bisa dihapus secara spesifik nanti.
Sitemap mahir.dev memakai pola ini (next: { revalidate: 300 }), sehingga daftar URL tidak diambil ulang dari API di setiap request.
Kalau beberapa fetch dalam satu route punya revalidate berbeda, route itu mengikuti nilai yang paling kecil.
Revalidasi on-demand
Daripada menunggu waktu habis, kamu bisa menghapus cache tepat setelah data berubah. Biasanya ini dilakukan di Server Action atau Route Handler yang menangani perubahan data.
revalidatePath
Menandai cache satu route sebagai basi. Request berikutnya ke route itu akan merender ulang dengan data baru.
ts
"use server";import { revalidatePath } from "next/cache";export async function updateCourse(slug: string) { // ...simpan perubahan ke database revalidatePath(`/belajar/${slug}`);}
revalidateTag
Menandai semua cache yang punya tag tertentu sebagai basi, di route mana pun. Cara ini lebih tepat kalau data yang sama dipakai di banyak halaman, misalnya judul course yang tampil di katalog, halaman detail, dan halaman lesson.
ts
import { revalidateTag } from "next/cache";revalidateTag("courses", "max");
Di Next.js 16, revalidateTag butuh argumen kedua berupa profil cache ("max" adalah yang paling umum). Bentuk dengan satu argumen sudah deprecated dan memunculkan error TypeScript.
Dengan profil "max", pengunjung berikutnya masih mendapat versi lama sekali, sementara versi baru dibuat di belakang layar (pola stale-while-revalidate). Ini aman untuk konten publik seperti katalog.
updateTag
Kalau pengguna baru saja mengubah sesuatu dan harus langsung melihat hasilnya (misalnya mengubah nama profil), pakai updateTag di Server Action. Request berikutnya menunggu data baru, bukan menyajikan versi lama.
ts
"use server";import { updateTag } from "next/cache";export async function updateProfile(formData: FormData) { // ...simpan perubahan updateTag("profile");}
updateTag hanya bisa dipanggil dari Server Action. Di Route Handler atau webhook, pakai revalidateTag dengan profil cache.
Webhook dari backend terpisah
Di mahir.dev, data course dikelola backend Go, bukan Server Action di Next.js. Polanya:
Admin menyimpan perubahan di backend.
Backend memanggil Route Handler di Next.js, misalnya POST /api/revalidate, dengan secret di header.
Route Handler memvalidasi secret, lalu memanggil revalidateTag("courses", "max").
Validasi secret itu wajib. Tanpanya, siapa pun bisa memanggil endpoint itu berulang kali dan memaksa server merender ulang terus-menerus.
Model baru: Cache Components
Next.js 16 memperkenalkan Cache Components, yang diaktifkan lewat cacheComponents: true di next.config.ts. Di model ini, kamu tidak lagi memakai export const dynamic atau export const revalidate. Kamu menandai fungsi atau komponen yang boleh di-cache dengan directive "use cache":
cacheLife mengatur berapa lama cache dipakai, dengan profil seperti "minutes", "hours", "days", atau "max".
cacheTag memberi label untuk revalidateTag atau updateTag.
Kunci cache dibuat otomatis dari argumen fungsi, jadi getLesson("a") dan getLesson("b") disimpan terpisah.
Bedanya dengan model lama: dengan Cache Components, satu halaman bisa terdiri dari bagian yang di-cache dan bagian yang dynamic. Bagian dynamic (misalnya yang membaca cookie) dibungkus <Suspense>. Inilah pilihan B di studi kasus lesson 10.
Dua catatan sebelum memakainya:
Mengaktifkan Cache Components mengubah perilaku seluruh aplikasi, jadi perlakukan sebagai migrasi, bukan perubahan kecil.
Secara default, cache "use cache" disimpan di memori server. Cache itu hilang saat server restart atau saat instance serverless dimatikan, dan tidak dibagi antar deployment. Untuk cache yang tahan lama, dokumentasi Next.js menyarankan "use cache: remote" atau cache handler.