Membaca Cache-Control, header yang dikirim Next.js per jenis route, jebakan revalidasi di CDN, dan cara cek cache di Cloudflare.
14m bacaanKuis WajibMicro Badge Lesson
Header cache dan CDN
Halaman static yang dibuat sekali di server tetap harus menempuh jarak dari server ke pengunjung. Kalau server ada di Singapura dan pengunjung di Jayapura, setiap request menempuh perjalanan jauh. CDN menyimpan salinan respons di server yang lebih dekat dengan pengunjung. Yang menentukan apa yang boleh disimpan dan berapa lama adalah header Cache-Control.
Membaca Cache-Control
Directive yang paling sering kamu temui:
Directive
Artinya
public
Boleh disimpan oleh siapa saja, termasuk CDN
private
Hanya boleh disimpan browser pengunjung itu, tidak oleh CDN
no-store
Tidak boleh disimpan sama sekali
max-age=N
Browser boleh memakai salinan selama N detik
s-maxage=N
CDN boleh memakai salinan selama N detik (mengalahkan max-age untuk CDN)
stale-while-revalidate=N
Setelah kedaluwarsa, salinan lama masih boleh dipakai selama N detik sambil versi baru diambil di belakang layar
immutable
Isinya tidak akan pernah berubah di URL ini
Kamu bisa melihat header ini di tab Network DevTools (klik request, lalu bagian Response Headers) atau lewat terminal:
Header untuk route dynamic sengaja ketat, supaya halaman yang berisi data pribadi tidak pernah tersimpan di CDN. Jangan menimpa header ini untuk halaman yang membaca cookie atau sesi.
Aset JS dan CSS bisa disimpan selamanya karena nama filenya berubah setiap kali isinya berubah. Browser yang sudah pernah mengunduhnya tidak perlu mengunduh ulang.
CDN dan revalidasi on-demand
Ada satu jebakan saat memakai CDN di depan Next.js. revalidatePath dan revalidateTag menghapus cache di server Next.js, tapi tidak di CDN. CDN tetap menyajikan salinannya sampai s-maxage habis.
Kalau perubahan harus segera terlihat, panggil API purge milik CDN bersamaan dengan revalidasi. Kalau tidak, pilih revalidate yang pendek supaya s-maxage di CDN juga pendek.
Cloudflare
Banyak web Indonesia memakai Cloudflare di depan server. Ada beberapa hal yang perlu kamu ketahui:
Secara default, Cloudflare hanya menyimpan file dengan ekstensi aset tertentu (gambar, CSS, JS, font). HTML tidak disimpan, walaupun header-nya public, s-maxage=.... Untuk menyimpan HTML, kamu perlu membuat Cache Rule.
Kalau kamu membuat Cache Rule untuk HTML, pastikan rule itu hanya berlaku untuk path yang memang publik, atau atur supaya Cloudflare menghormati header dari server. Halaman yang membaca cookie sesi tidak boleh ikut tersimpan.
Header cf-cache-status di respons menunjukkan hasilnya: HIT berarti disajikan dari cache Cloudflare, MISS berarti boleh disimpan tapi belum ada di cache sehingga diambil dari server, BYPASS berarti server mengirim header yang melarang penyimpanan (misalnya no-store atau private), dan DYNAMIC berarti Cloudflare tidak menganggap respons itu layak disimpan, misalnya HTML tanpa Cache Rule. Cloudflare juga tidak menyimpan respons yang membawa Set-Cookie.
Request pertama REVALIDATED: salinan di edge sudah kedaluwarsa, jadi Cloudflare mengecek ulang ke origin dan mendapat jawaban bahwa file belum berubah. Request kedua HIT: langsung disajikan dari cache. Bandingkan dengan halaman mahir.dev/belajar, yang tidak mengirim cf-cache-status sama sekali karena tidak melewati Cloudflare, dan mengirim cache-control: private, no-cache, no-store, max-age=0, must-revalidate karena route-nya dynamic (lesson 10).
Checklist header cache
route publik yang static atau ISR mengirim s-maxage, bukan no-store
route yang membaca cookie atau sesi mengirim private atau no-store
aset JS, CSS, dan font mengirim max-age panjang dan immutable
kalau memakai CDN, request kedua untuk halaman publik menghasilkan HIT
ada rencana purge CDN untuk konten yang harus segera diperbarui
Penutup modul
Kamu sekarang punya tiga alat untuk menurunkan TTFB: memilih strategi render yang tepat per route, menyimpan data di cache server, dan menyimpan respons di CDN. Modul berikutnya pindah ke sisi browser: aset yang memperlambat halaman setelah HTML-nya diterima.
Checkpoint KuisTarget: 70%
Kuis: Header cache dan CDN
Kuis ini wajib untuk sertifikat. Kamu tetap bisa lanjut ke pelajaran berikutnya dan mengerjakannya nanti.