Mencegah query lambat menahan seluruh halaman dynamic dengan Suspense, loading.tsx, dan query paralel.
14m bacaanKuis WajibMicro Badge Lesson
Streaming dan loading.tsx untuk halaman berat
Tidak semua halaman bisa dibuat static. Dashboard, halaman akun, dan hasil pencarian memang harus dirender per request. Untuk halaman seperti ini, tujuannya berubah: bukan menghilangkan waktu render, tapi mencegah bagian yang lambat menahan bagian yang cepat.
Masalah: satu query lambat menahan seluruh halaman
Bayangkan halaman dashboard dengan tiga bagian:
tsx
export default async function DashboardPage() { const user = await getUser(); // cepat const courses = await getMyCourses(); // cepat const stats = await getLearningStats(); // lambat, agregasi berat return ( <> <Header user={user} /> <CourseList courses={courses} /> <Stats stats={stats} /> </> );}
Server baru mengirim HTML setelah ketiga query selesai. Kalau getLearningStats() butuh 1,5 detik, pengunjung menatap layar kosong selama 1,5 detik, padahal header dan daftar course sudah siap jauh sebelumnya.
Ada juga masalah kedua: ketiga await berjalan berurutan. Query kedua baru mulai setelah query pertama selesai.
Streaming dengan <Suspense>
Dengan streaming, server mengirim HTML secara bertahap. Bagian yang sudah siap dikirim lebih dulu, lalu bagian yang lambat menyusul di respons yang sama.
Sekarang browser menerima header, daftar course, dan StatsSkeleton lebih dulu. Saat getLearningStats() selesai, server mengirim HTML Stats dan React menukarnya dengan skeleton.
Kuncinya: query lambat dipindahkan ke dalam komponen yang dibungkus <Suspense>. Kalau await getLearningStats() tetap di page, streaming tidak membantu.
loading.tsx
File loading.tsx di sebuah folder route adalah cara singkat untuk membungkus seluruh page di folder itu dengan <Suspense>:
tsx
// app/dashboard/loading.tsxexport default function Loading() { return <DashboardSkeleton />;}
Saat pengunjung membuka /dashboard, layout dan DashboardSkeleton langsung tampil, lalu isi page menyusul. loading.tsx juga membuat navigasi antar halaman terasa langsung merespons, karena skeleton muncul seketika setelah link diklik.
Bedanya dengan <Suspense> manual: loading.tsx membungkus seluruh page, sedangkan <Suspense> bisa membungkus bagian tertentu saja. Pakai loading.tsx sebagai dasar, lalu <Suspense> untuk bagian yang jauh lebih lambat dari yang lain.
Menjalankan query secara paralel
Untuk query yang tidak saling bergantung, jalankan bersamaan:
Total waktunya menjadi sepanjang query yang paling lambat, bukan jumlah keduanya. Cek waterfall query seperti kamu mengecek waterfall request di Modul 2: setiap await berurutan adalah satu anak tangga.
Skeleton dan CLS
Skeleton yang ukurannya berbeda dengan konten aslinya menyebabkan layout shift saat konten masuk. Buat skeleton dengan tinggi yang sama, atau setidaknya mendekati, dengan konten yang akan menggantikannya.
Streaming dan SEO
Googlebot menerima seluruh respons streaming, termasuk bagian yang dikirim belakangan. Tapi ingat batas antara halaman publik dan halaman per pengunjung:
Halaman publik (artikel, detail produk): konten utama sebaiknya ada di bagian yang dikirim pertama, tidak di dalam <Suspense>. Pakai streaming untuk bagian sekunder seperti komentar atau rekomendasi.
Halaman private (dashboard): tidak perlu di-index, jadi streaming sepenuhnya urusan pengalaman pengguna.
Latihan
Ambil satu halaman dynamic di proyekmu:
Tulis daftar semua await di page beserta perkiraan durasinya.
Tandai mana yang bisa diparalelkan dengan Promise.all.
Tandai mana yang cukup lambat untuk dipindahkan ke balik <Suspense>.
Ukur TTFB dan LCP sebelum dan sesudah perubahan.
Checkpoint KuisTarget: 70%
Kuis: Streaming dan loading.tsx
Kuis ini wajib untuk sertifikat. Kamu tetap bisa lanjut ke pelajaran berikutnya dan mengerjakannya nanti.