BAB 5: React Upgrade
Memahami perbedaan antar versi React, cara mengupgrade proyek, dan hal-hal yang perlu diperhatikan saat migrasi.
Di bab sebelumnya, kita mengupas createRoot, bagaimana React mengambil kendali atas sebuah div dan mengisinya dengan seluruh antarmuka aplikasi. Mungkin kamu sempat bertanya-tanya: kenapa harus ada createRoot? Bukankah sebelumnya React punya cara lain yang lebih sederhana?
Pertanyaan itu tepat. createRoot bukan API yang sudah ada sejak awal React. Ia hadir karena React mengalami perubahan besar, dan cara lama harus digantikan. Untuk developer yang bekerja di proyek yang sudah berjalan (atau yang suatu hari nanti harus memperbarui proyek lama ke React modern) memahami cara kerja upgrade menjadi pengetahuan yang krusial.
Sekilas Sejarah Versi React
React pertama kali dirilis Facebook ke publik pada 2013. Sejak saat itu, ia terus berkembang, tapi ada beberapa versi yang menandai perubahan signifikan:
- React 16 (2017): Penulisan ulang besar-besaran internal React menggunakan arsitektur Fiber. Perubahan API minimal, tapi fondasi dikerjakan ulang dari nol.
- React 17 (2020): Versi transisi. Tidak ada fitur baru yang mencolok untuk developer, tapi menyiapkan ekosistem untuk perubahan besar berikutnya.
- React 18 (Maret 2022): Concurrent rendering masuk,
createRootdiperkenalkan, danReactDOM.renderresmi deprecated. Automatic batching diaktifkan secara default. - React 18.3 (Agustus 2024): Rilis khusus yang menampilkan semua peringatan deprecation untuk membantu developer bersiap sebelum React 19.
- React 19 (Desember 2024): API lama yang sudah deprecated dihapus sepenuhnya.
ReactDOM.rendertidak lagi tersedia. React Compiler hadir sebagai fitur eksperimental.
Ebook ini menggunakan React 19, sehingga semua kode ditulis mengikuti API terbaru.
Cara Lama: ReactDOM.render
Sebelum React 18, cara standar memulai aplikasi React adalah seperti ini:
// main.jsx: gaya React 17 ke bawah (TIDAK LAGI BERLAKU)
import React from 'react'
import ReactDOM from 'react-dom'
import App from './App'
ReactDOM.render(<App />, document.getElementById('root'))
Sintaks ini sangat ringkas, cukup satu baris untuk menghubungkan React ke DOM. Tapi di balik kesederhanaannya, ada keterbatasan arsitektur yang mencegah React mengimplementasikan fitur concurrent rendering.
Di React 19, ReactDOM.render sudah dihapus sepenuhnya. Proyek yang masih menggunakannya akan melempar error saat runtime, bukan hanya peringatan di konsol.
Cara Baru: createRoot
Sejak React 18, cara yang benar adalah menggunakan createRoot dari react-dom/client:
// main.jsx: gaya React 18+ (yang kita gunakan)
import { createRoot } from 'react-dom/client'
import App from './App'
createRoot(document.getElementById('root')).render(<App />)
Perbedaannya bukan sekadar kosmetik. Dengan createRoot, React mendapatkan kemampuan untuk:
- Menjalankan rendering secara concurrent: React bisa menghentikan, melanjutkan, atau membatalkan pekerjaan rendering di tengah jalan
- Melakukan automatic batching, beberapa perubahan state dalam satu event handler diproses sekaligus dalam satu render, bukan satu per satu
- Menggunakan fitur-fitur baru seperti
SuspensedanuseTransitionsecara penuh
Kode yang kita tulis sejak Bab 3 sudah menggunakan createRoot, jadi kamu tidak perlu mengubah apapun. Tapi penting untuk tahu mengapa kita menulis seperti itu, bukan hanya bagaimana menulisnya.
Mengupgrade Proyek React Lama
Kalau kamu punya proyek React yang masih menggunakan versi lama dan perlu diperbarui ke React 19, prosesnya berjalan dalam beberapa langkah.
Periksa Versi Saat Ini
Buka package.json proyek dan lihat berapa versi React yang terpasang:
// package.json
{
"dependencies": {
"react": "^17.0.2",
"react-dom": "^17.0.2"
}
}
Install Versi Terbaru
Perbarui react dan react-dom ke versi terbaru:
npm install react@latest react-dom@latest
Atau menggunakan bun (yang kita pakai di ebook ini):
bun add react@latest react-dom@latest
Dua paket ini selalu diupdate bersama, pastikan versinya selalu sama antara react dan react-dom.
Ganti ReactDOM.render dengan createRoot
Cari semua file yang menggunakan ReactDOM.render, biasanya ada di main.jsx, main.tsx, atau index.js. Ganti dengan pola createRoot:
// SEBELUM: hapus ini
import ReactDOM from 'react-dom'
ReactDOM.render(<App />, document.getElementById('root'))
// SESUDAH: ganti dengan ini
import { createRoot } from 'react-dom/client'
createRoot(document.getElementById('root')).render(<App />)
Perhatikan dua perubahan sekaligus: import-nya berubah (dari react-dom ke react-dom/client, dan menggunakan named import), serta cara pemanggilannya berubah.
Periksa API yang Dihapus
React 19 menghapus beberapa API selain ReactDOM.render. Jika proyekmu cukup lama, ada kemungkinan ia menggunakan salah satu dari berikut:
| API Lama | Pengganti |
|---|---|
ReactDOM.render() | createRoot().render() |
ReactDOM.hydrate() | hydrateRoot() |
unmountComponentAtNode() | root.unmount() |
String refs (ref="inputRef") | useRef() atau ref callback |
defaultProps pada functional component | Default parameter di fungsi |
Untuk proyek besar dengan banyak komponen lama, React menyediakan tool bernama codemod yang bisa mengotomasi sebagian perubahan ini:
npx codemod@latest react/19/migration-recipe
Codemod akan menelusuri seluruh kode dan mengubah pola lama ke pola baru secara otomatis. Tetap perlu direview manual setelahnya, tapi ini menghemat banyak waktu.
Strategi Upgrade yang Aman
Mengupgrade proyek production React tidak harus dilakukan sekaligus. Ada strategi bertahap yang lebih aman.
Pertama, upgrade ke React 18.3 sebelum langsung ke React 19. React 18.3 sengaja dirilis untuk menampilkan semua peringatan deprecation, artinya proyekmu masih berjalan, tapi konsol akan penuh dengan peringatan tentang API yang akan dihapus. Ini membantu mengidentifikasi apa saja yang perlu diubah.
Kedua, perbaiki semua peringatan yang muncul di konsol satu per satu. Setiap peringatan biasanya menyebutkan API mana yang deprecated dan apa penggantinya.
Ketiga, setelah konsol bersih dari peringatan, baru upgrade ke React 19. Migrasi menjadi lebih mulus karena tidak ada kejutan.
Untuk proyek baru seperti yang kita buat di ebook ini, kamu tidak perlu memikirkan langkah-langkah di atas. Kamu sudah mulai dengan React 19 sejak awal, tidak ada yang perlu di-upgrade.
Latihan
Coba dua eksperimen berikut untuk membangun pemahaman tentang perbedaan versi:
-
Buka
package.jsondi proyekdaftar-tugas. Catat versireactdanreact-domyang terpasang. Pastikan keduanya sama dan merupakan versi 19 ke atas. -
Di
main.jsx, coba tambahkanonUncaughtErrorsebagai opsi keduacreateRoot, ini adalah fitur baru React 19 yang memungkinkan penanganan error global:
// src/main.jsx: dengan error handler
import { createRoot } from 'react-dom/client'
import App from './App'
createRoot(document.getElementById('root'), {
onUncaughtError: (error) => {
console.error('Error tidak tertangani:', error)
}
}).render(<App />)
Perhatikan bahwa opsi ini tidak ada di React 17 atau lebih awal, ia hanya tersedia di React 19. Setelah coba, kamu bisa kembalikan ke bentuk semula tanpa opsi tersebut.
Penutup
React berevolusi karena kebutuhan nyata: concurrent rendering tidak bisa diimplementasikan dengan arsitektur ReactDOM.render yang lama. Perubahan ke createRoot bukan sekadar ganti nama, ia membuka pintu ke kemampuan-kemampuan yang menjadi fondasi fitur-fitur modern React.
Untuk proyek yang kita bangun di ebook ini, semua ini sudah tersedia secara otomatis sejak awal. Tapi pemahaman ini akan berguna saat kamu nanti menemukan tutorial lama, proyek warisan, atau kode yang ditulis sebelum React 18, kamu bisa mengidentifikasi pola mana yang sudah usang dan tahu persis cara memperbaruinya.
Di bab berikutnya, kita akan sedikit mundur dari React dan melihat JavaScript modern yang menjadi fondasinya. Sebelum lebih dalam ke React, ada sejumlah fitur ES6+ yang perlu dipahami dengan baik, karena hampir semua kode React yang akan kita tulis ke depan bergantung pada fitur-fitur itu.