BAB 14: Props Destructuring
Sederhanakan akses props dengan destructuring langsung di parameter fungsi, pola yang hampir selalu digunakan di kode React modern.
Setiap kali kita mengakses props.judul, props.status, atau props.nomor di bab sebelumnya, ada pengulangan yang terasa sedikit mengganggu, nama props muncul di mana-mana. Untuk komponen sederhana ini tidak masalah, tapi bayangkan komponen yang menerima delapan props berbeda: kode di dalam return akan penuh dengan props.ini, props.itu, dan props.sana.
Destructuring adalah fitur JavaScript yang memungkinkan kita mengekstrak nilai dari objek ke variabel-variabel tersendiri dalam satu baris. Di React, ini adalah cara yang hampir selalu digunakan untuk mengakses props, bukan karena wajib, tapi karena kode yang dihasilkan jauh lebih bersih dan mudah dibaca.
Destructuring di Dalam Komponen
Cara paling mudah memulai adalah dengan melakukan destructuring di baris pertama komponen, setelah menerima props sebagai argumen:
// src/components/KartuTugas.jsx
// cara lama: menggunakan props.xxx
function KartuTugas(props) {
return (
<div className="kartu-tugas">
<h3>{props.judul}</h3>
<span className="badge">{props.status}</span>
<small>#{props.nomor}</small>
</div>
)
}
// src/components/KartuTugas.jsx
// dengan destructuring di dalam komponen
function KartuTugas(props) {
const { judul, status, nomor } = props
return (
<div className="kartu-tugas">
<h3>{judul}</h3>
<span className="badge">{status}</span>
<small>#{nomor}</small>
</div>
)
}
export default KartuTugas
Hasilnya identik, yang berubah hanya cara kita membaca props di dalam komponen. Setelah baris const { judul, status, nomor } = props, ketiga variabel itu sudah bisa digunakan langsung tanpa prefix props..
Destructuring Langsung di Parameter
Cara yang lebih ringkas dan lebih umum ditemukan di kode React modern: lakukan destructuring langsung di parameter fungsi.
// src/components/KartuTugas.jsx
// destructuring langsung di parameter
function KartuTugas({ judul, status, nomor }) {
return (
<div className="kartu-tugas">
<h3>{judul}</h3>
<span className="badge">{status}</span>
<small>#{nomor}</small>
</div>
)
}
export default KartuTugas
Tanda kurung kurawal { } di dalam parameter fungsi bukan blok kode, itu adalah sintaks destructuring. Kita memberi tahu JavaScript: "parameter pertama fungsi ini adalah objek, dan saya hanya butuh properti judul, status, dan nomor darinya."
Cara penggunaan di App.jsx tidak berubah sama sekali:
// src/App.jsx
<KartuTugas judul="Buat halaman login" status="Aktif" nomor={1} />
React tetap mengirim semua props sebagai satu objek, destructuring hanya mengubah cara kita menerimanya di sisi komponen.
Di codebase React modern, hampir semua komponen menggunakan destructuring langsung di parameter. Ini bukan sekadar preferensi gaya, ketika membaca definisi fungsi, kamu langsung tahu props apa saja yang dibutuhkan komponen tanpa harus membaca keseluruhan kode di dalamnya.
Nilai Default untuk Props
Destructuring juga memungkinkan kita menentukan nilai default untuk props yang tidak dikirim. Ini berguna ketika sebuah props bersifat opsional tapi komponen tetap perlu berfungsi jika props itu tidak ada.
// src/components/KartuTugas.jsx
// dengan nilai default
function KartuTugas({ judul, status = "Pending", nomor = 0, terlambat = false }) {
return (
<div className={`kartu-tugas ${terlambat ? 'terlambat' : ''}`}>
<h3>{judul}</h3>
<span className="badge">{status}</span>
<small>#{nomor}</small>
</div>
)
}
export default KartuTugas
Sekarang jika kamu merender <KartuTugas judul="Buat halaman login" /> tanpa mengirim status, nomor, atau terlambat, komponen akan menggunakan nilai default: "Pending", 0, dan false.
Nilai default hanya aktif ketika props-nya tidak dikirim sama sekali, atau dikirim dengan nilai undefined. Jika kamu mengirim status={null}, nilai default tidak akan digunakan, komponen akan menerima null apa adanya.
Hati-hati membedakan undefined dan null. status={undefined} akan mengaktifkan nilai default, tapi status={null} tidak. Ini perilaku bawaan destructuring JavaScript, bukan khusus React.
Rest Operator di Props
Terkadang kamu perlu meneruskan sebagian besar props ke elemen atau komponen lain, tapi ingin memisahkan satu atau dua props yang perlu ditangani sendiri. Di sinilah rest operator (...rest) berguna.
// src/components/KartuTugas.jsx
// memisahkan props yang ditangani sendiri vs sisanya
function KartuTugas({ judul, status, ...sisaProps }) {
return (
<div {...sisaProps} className={`kartu-tugas ${sisaProps.className || ''}`}>
<h3>{judul}</h3>
<span className="badge">{status}</span>
</div>
)
}
export default KartuTugas
Variabel sisaProps akan berisi semua props selain judul dan status. Jika komponen dipanggil seperti ini:
<KartuTugas
judul="Buat halaman login"
status="Aktif"
id="tugas-001"
data-testid="kartu-pertama"
/>
Maka sisaProps akan berisi { id: "tugas-001", "data-testid": "kartu-pertama" }. Kita bisa menyebarkannya ke elemen HTML menggunakan {...sisaProps}.
Pola ini sering digunakan saat membuat komponen wrapper yang perlu meneruskan props HTML standar (seperti id, className, aria-*, data-*) ke elemen DOM di dalamnya.
Destructuring Props Objek Bertingkat
Ketika props berupa objek yang punya properti di dalamnya, destructuring bisa dilakukan bertingkat:
// src/components/KartuTugas.jsx
// props info adalah objek dengan properti di dalamnya
function KartuTugas({ judul, info: { tenggat, prioritas } }) {
return (
<div className="kartu-tugas">
<h3>{judul}</h3>
<small>Tenggat: {tenggat}</small>
<span className="prioritas">P{prioritas}</span>
</div>
)
}
export default KartuTugas
Penggunaan:
<KartuTugas
judul="Deploy ke production"
info={{ tenggat: "2026-03-20", prioritas: 1 }}
/>
Sintaks info: { tenggat, prioritas } artinya: dari props info, ambil properti tenggat dan prioritas. Variabel info sendiri tidak tersedia di dalam komponen, yang tersedia hanya tenggat dan prioritas.
Destructuring bertingkat bisa terasa padat jika objeknya dalam. Jika ini terjadi, pertimbangkan untuk melakukan destructuring dalam dua langkah di dalam komponen, bukan semuanya di parameter:
// lebih mudah dibaca untuk struktur yang dalam
function KartuTugas({ judul, info }) {
const { tenggat, prioritas, penugasan: { nama } } = info
return (
<div className="kartu-tugas">
<h3>{judul}</h3>
<small>Tenggat: {tenggat} | Prioritas: P{prioritas}</small>
<span>Ditugaskan ke: {nama}</span>
</div>
)
}
Latihan
Kembali ke komponen KartuTugas dan ProfilAnggota yang sudah dibuat di latihan bab sebelumnya:
-
Ubah semua komponen yang masih menggunakan
props.xxxmenjadi destructuring di parameter fungsi. Pastikan perilaku komponen tidak berubah. -
Tambahkan nilai default ke
ProfilAnggota: jika propsperantidak dikirim, tampilkan"Anggota"sebagai default. -
Buat komponen
TombolAksiyang menerima propslabel,variant(default"primary"), dandisabled(defaultfalse), plus semua props HTML lain menggunakan rest operator. Teruskan rest props ke elemen<button>di dalamnya agar komponen ini bisa menerimaonClick,type,aria-label, dan atribut lainnya secara langsung.
Penutup
Destructuring props bukan fitur React, ini fitur JavaScript yang kebetulan sangat cocok dengan cara React bekerja. Tapi dampaknya besar: kode komponen menjadi lebih bersih, lebih eksplisit tentang data apa yang dibutuhkan, dan lebih mudah dibaca oleh siapapun yang melihatnya untuk pertama kali.
Sejauh ini props yang kita bahas mengalir satu arah: dari induk ke anak. Tapi sering kali kita juga butuh sesuatu yang bisa dibungkus (komponen yang menjadi wadah bagi konten arbitrer dari luar, bukan hanya menerima nilai-nilai tertentu. Di bab berikutnya, kita akan membahas props.children) mekanisme yang membuat pola komposisi komponen di React menjadi sangat fleksibel.