Lewati ke konten
Pengembangan Web

Partial Prerendering (PPR) Next.js 16

M. Irfan Ramadhan3 menit baca
Layar laptop menampilkan kode pemrograman berwarna-warni di ruangan gelap.
Foto: Pexels
Daftar Isi

Partial Prerendering (PPR) adalah teknik rendering Next.js 16 yang menggabungkan static shell hasil prerender saat build dengan konten dinamis yang di-stream belakangan, dalam satu route yang sama. Shell statis dikirim instan ke browser, lalu bagian dinamis menyusul lewat batas Suspense, sehingga halaman terasa cepat tanpa kehilangan data real-time.

Ringkasan cepat:

  1. PPR menggabungkan static shell hasil prerender saat build dengan konten dinamis yang di-stream belakangan, dalam satu route yang sama.
  2. Sejak Next.js 16, PPR sudah stabil dan otomatis aktif lewat opsi cacheComponents: true di next.config.ts, menggantikan flag eksperimental experimental.ppr dan experimental_ppr per-route dari Next.js 14-15 yang sudah dihapus total.
  3. Batas statis dan dinamis ditentukan lewat komponen <Suspense> React: semua di luar boundary diprerender jadi static shell, semua di dalamnya di-stream setelah shell terkirim.
  4. cacheComponents mengaktifkan PPR sekaligus directive use cache, cacheLife, dan cacheTag secara bersamaan sebagai satu konfigurasi terpadu.
  5. PPR beda dari streaming biasa (loading.js sejak Next.js 13) karena static shell-nya sudah diprerender di build time, bukan menunggu request masuk lebih dulu.

Apa Itu Partial Prerendering di Next.js 16?

Sebelum PPR, sebuah route pada dasarnya harus memilih salah satu: statis penuh (cepat tapi datanya bisa basi) atau dinamis penuh (data selalu segar tapi setiap request menunggu server). PPR menghapus pilihan itu dengan mencampur keduanya di level komponen dalam satu halaman yang sama.

AspekStatis Penuh (SSG)Dinamis Penuh (SSR)Partial Prerendering (PPR)
Respons awalInstan, dikirim dari hasil buildMenunggu server memproses tiap requestInstan lewat static shell yang diprerender
Kesegaran dataBisa basi, tetap sama sampai build berikutnyaSelalu segar, digenerate ulang tiap requestSegar untuk bagian dalam boundary Suspense, shell tetap statis
Kapan render terjadiSekali saat buildSetiap kali ada request masukShell saat build, konten dinamis di-stream saat request
Cara aktivasi di Next.js 16Default untuk route tanpa API request-timeOtomatis untuk route yang pakai API request-time di luar SuspenseOtomatis lewat cacheComponents: true di next.config.ts

Menurut glosarium resmi Next.js:

A rendering optimization that combines prerendering and dynamic rendering in a single route. The static shell is served immediately while dynamic content streams in when ready, providing the best of both rendering strategies.

— Next.js Glossary, definisi Partial Prerendering (PPR)

Bagian yang diprerender disebut static shell: struktur HTML yang sudah lengkap berisi semua konten statis ditambah fallback dari boundary Suspense untuk bagian yang belum siap.

Blog Vercel yang mengumumkan PPR pertama kali menjelaskan posisinya dibandingkan dua model rendering yang sudah ada:

PPR offers a unified model that blends the reliability and speed of Incremental Static Regeneration (ISR) and the dynamic capabilities of Server-Side Rendering (SSR).

— Sebastian Markbåge & Malte Ubl, Partial Prerendering, Vercel Blog

Kenapa Ini Beda dari Streaming Biasa?

Streaming lewat loading.js sudah ada sejak Next.js 13, tapi seluruh halaman baru mulai dikirim setelah request masuk. PPR mengirim static shell yang sudah diprerender di build time terlebih dulu, jadi bagian statis muncul instan tanpa menunggu server memproses apa pun, baru kemudian bagian dinamis di-stream menyusul di dalam boundary yang sama.

Bagaimana Cara Kerja PPR Setelah Next.js 16?

PPR tidak lagi jadi flag terpisah yang harus diaktifkan sendiri. Sesuai dokumentasi resmi opsi cacheComponents, mengaktifkan cacheComponents: true di next.config.ts otomatis membuat PPR jadi perilaku default App Router:

import type { NextConfig } from "next";
 
const nextConfig: NextConfig = {
  cacheComponents: true,
};
 
export default nextConfig;

Flag experimental.ppr di level konfigurasi dan experimental_ppr di level route segment yang dipakai eksperimen sejak Next.js 14-15 sudah dihapus total di Next.js 16, digantikan satu opsi cacheComponents yang mengatur PPR, use cache, dan dynamicIO sekaligus sebagai satu konfigurasi terpadu. Artikel Cache Components Next.js 16 di blog ini membahas lebih dalam soal directive use cache, cacheLife, dan cacheTag yang jadi pasangan kerja PPR untuk mengatur bagian mana yang di-cache dan berapa lama.

Menandai Batas Statis dan Dinamis

Batas antara static shell dan konten yang di-stream ditentukan lewat komponen <Suspense> bawaan React:

import { Suspense } from "react";
 
export default function Page() {
  return (
    <main>
      <StaticHeader />
      <Suspense fallback={<ProductSkeleton />}>
        <DynamicProductList />
      </Suspense>
    </main>
  );
}

StaticHeader diprerender jadi bagian static shell karena tidak memakai API request-time apa pun. DynamicProductList yang membaca cookies(), headers(), atau searchParams otomatis opt-in ke dynamic rendering, tapi karena dibungkus <Suspense>, fallback-nya (ProductSkeleton) ikut masuk static shell, sementara konten aslinya di-stream begitu selesai dirender di server.

Ringkasan: Suspense Menentukan Batas, cacheComponents Mengaktifkannya Secara Stabil

  • PPR menggabungkan static shell hasil prerender dengan konten dinamis yang di-stream, dalam satu route, lewat batas <Suspense>.
  • Sejak Next.js 16, PPR sudah stabil dan otomatis aktif lewat opsi cacheComponents: true, menggantikan flag eksperimental ppr di Next.js 14-15.
  • PPR bekerja berpasangan dengan directive use cache (dibahas lengkap di Cache Components Next.js 16): PPR menentukan batas statis/dinamis, use cache menentukan cache data di dalamnya.
  • Kalau proyekmu masih di Next.js 15 dan ingin migrasi untuk memakai PPR stabil ini, tim layanan web development bisa membantu audit dan eksekusi upgrade-nya.

nextjs · nextjs-16 · partial-prerendering · ppr · cache-components

Pertanyaan yang Sering Diajukan

Apa itu Partial Prerendering (PPR) di Next.js 16?

PPR adalah teknik rendering yang menggabungkan static shell (prerender saat build) dengan konten dinamis yang di-stream belakangan dalam satu route yang sama. Shell statis langsung dikirim ke browser, lalu bagian dinamis menyusul lewat Suspense boundary, jadi halaman terasa cepat tanpa mengorbankan data real-time.

Apakah PPR masih fitur eksperimental di Next.js 16?

Tidak. PPR sudah stabil secara default di Next.js 16 lewat opsi cacheComponents: true di next.config.ts, menggantikan flag experimental.ppr di level konfigurasi dan experimental_ppr per-route segment yang dipakai sejak eksperimen Next.js 14-15. Kedua flag lama itu sudah dihapus total di versi 16, digantikan satu opsi cacheComponents yang sekaligus mengatur PPR, use cache, dan dynamicIO sebagai satu konfigurasi terpadu.

Apa hubungan PPR dengan Cache Components dan use cache?

cacheComponents adalah satu opsi konfigurasi yang mengaktifkan PPR sekaligus directive "use cache", cacheLife, dan cacheTag secara bersamaan. PPR mengatur DI MANA batas statis dan dinamis sebuah halaman lewat Suspense, sedangkan use cache mengatur bagian mana yang datanya disimpan dan berapa lama.

Bagaimana cara menandai bagian dinamis dalam PPR?

Bungkus komponen yang memakai data request-time seperti cookies(), headers(), atau searchParams dengan komponen <Suspense> React. Semua yang berada di luar boundary Suspense diprerender jadi bagian static shell, sedangkan komponen di dalamnya otomatis opt-in ke dynamic rendering. Fallback Suspense itu sendiri, misalnya skeleton loading, ikut masuk static shell, sementara konten aslinya baru di-stream setelah selesai dirender di server.

Artikel Terkait

M. Irfan Ramadhan

SEO Specialist & Web Developer

Menulis tentang SEO teknis, GEO/AI search, dan pengembangan web modern berdasarkan pengalaman langsung mengerjakan proyek klien.