Error Boundary & Penanganan Form Kompleks di React: Mencegah Layar Putih (White Screen) di Produksi
Salah satu insiden produksi paling memalukan di aplikasi React adalah kemunculan White Screen of Death: seluruh layar tiba-tiba berubah menjadi kanvas putih kosong hanya karena satu properti opsional (misalnya author.profile.avatar) bernilai undefined pada satu widget statistik kecil di pojok halaman.
Mengapa React melepas seluruh antarmuka hanya gara-gara satu widget? Karena sejak React 16, setiap galat JavaScript tak tertangani saat fase render dianggap merusak konsistensi pohon komponen—React memilih meng-unmount seluruh pohon di bawah titik crash daripada membiarkan data setengah rusak tampil ke pengguna. Melanjutkan seri dasar React Hooks dan Custom Hooks Fetch API, mari kita bangun mekanisme Error Boundary granular serta pola penanganan form asinkron yang tahan banting.
1. Mengapa Try/Catch Biasa Tidak Menangkap Error Render JSX
Blok try { ... } catch hanya bekerja untuk kode imperatif, sedangkan JSX bersifat deklaratif. Saat Anda menulis <ProfileCard user={user} />, Anda sebenarnya hanya mengembalikan objek deskripsi elemen untuk dievaluasi oleh React di dalam fase render.
Satu-satunya mekanisme resmi untuk menangkap galat render anak adalah komponen class yang mendefinisikan metode siklus hidup static getDerivedStateFromError() dan componentDidCatch()—yang lazim disebut Error Boundary (atau lewat pustaka ringan react-error-boundary bila tidak ingin menulis class sendiri).

2. Membuat Komponen WidgetErrorBoundary Lengkap dengan Tombol Reset
Memasang satu Error Boundary di level paling atas <App /> memang lebih baik daripada layar putih, tetapi masih menonaktifkan seluruh halaman. Praktik terbaik adalah memasang Error Boundary di batas masing-masing fitur independen (sidebar analitik, panel komentar, form editor):
// src/components/WidgetErrorBoundary.jsx
import { Component } from 'react';
export class WidgetErrorBoundary extends Component {
constructor(props) {
super(props);
this.state = { hasError: false, message: '' };
}
static getDerivedStateFromError(error) {
return {
hasError: true,
message: error?.message || 'Komponen gagal dimuat.',
};
}
componentDidCatch(error, errorInfo) {
// Kirim log terstruktur ke server monitoring / console, hindari membocorkan stack ke UI
console.error('[UI Boundary Caught]', {
feature: this.props.featureName ?? 'unknown',
error: error.message,
componentStack: errorInfo.componentStack,
});
}
handleReset = () => {
this.setState({ hasError: false, message: '' });
this.props.onRetry?.();
};
render() {
if (this.state.hasError) {
return (
<div role="alert" className="rounded-xl border border-rose-200 bg-rose-50 p-4 text-sm text-rose-800">
<p className="font-semibold">Bagian ini sedang mengalami gangguan tampilan.</p>
<button type="button" onClick={this.handleReset} className="mt-2 underline">
Coba Muat Ulang
</button>
</div>
);
}
return this.props.children;
}
}
3. Apa yang TIDAK Tertangkap oleh Error Boundary (dan Cara Menanganinya di Form)
Kesalahan pemahaman paling umum adalah menyangka Error Boundary akan menangkap kegagalan saat pengguna mengklik tombol simpan. Error Boundary tidak menangkap error pada:
- Event handler seperti
onClickatauonSubmit. - Operasi asinkron (
fetch(),setTimeout, Promise yang ditolak). - Error di dalam komponen Error Boundary itu sendiri.
Untuk pengiriman formulir asinkron di produksi, gabungkan state eksplisit status (idle | submitting | error | success), penguncian klik ganda, serta pemetaan pesan galat server yang terstruktur:
export function PublishArticleForm({ onPublish }) {
const [title, setTitle] = useState('');
const [submitting, setSubmitting] = useState(false);
const [formError, setFormError] = useState(null);
async function handleSubmit(event) {
event.preventDefault();
if (submitting) return;
setSubmitting(true);
setFormError(null);
try {
const response = await fetch('/api/posts', {
method: 'POST',
headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
body: JSON.stringify({ title: title.trim() }),
});
const payload = await response.json().catch(() => ({}));
if (!response.ok) {
throw new Error(payload.message || `Gagal menyimpan (HTTP ${response.status}).`);
}
onPublish?.(payload.data);
} catch (err) {
setFormError(err.message || 'Koneksi ke server terganggu. Draf Anda masih aman.');
} finally {
setSubmitting(false);
}
}
return (
<form onSubmit={handleSubmit} className="space-y-4">
{formError && (
<div role="alert" className="rounded-lg bg-rose-50 p-3 text-sm text-rose-700">
{formError}
</div>
)}
<input value={title} onChange={(e) => setTitle(e.target.value)} required />
<button type="submit" disabled={submitting}>
{submitting ? 'Menyimpan...' : 'Publikasikan'}
</button>
</form>
);
}
Peta Penanganan Error Berdasarkan Jenisnya di React
| Sumber Error | Tertangkap Error Boundary? | Cara Penanganan Tepat |
|---|---|---|
Crash saat render JSX / akses properti undefined |
Ya | Bungkus area fitur memakai <WidgetErrorBoundary> plus fallback & tombol reset. |
Kegagalan HTTP 422 / 500 saat onSubmit form |
Tidak | Tangkap memakai try/catch di dalam handler dan tampilkan banner/inline error agar input user tidak hilang. |
| Chunk Lazy Load gagal diunduh akibat koneksi putus / deploy baru | Ya (di sekitar <Suspense>) |
Pasang Error Boundary di luar <Suspense> agar bisa menawarkan tombol muat ulang halaman. |
Tips tambahan: saat memparsing respons gagal dengan await response.json(), selalu tambahkan .catch(() => ({})) seperti contoh di atas. Sering kali server reverse proxy (misalnya Nginx 502 Bad Gateway) mengembalikan halaman HTML, bukan JSON—tanpa penjagaan tersebut, blok catch justru melempar SyntaxError: Unexpected token '<' yang membingungkan pengguna.
Diskusi & Komentar
0Sampaikan pertanyaan teknis, masukan, atau feedback Anda seputar artikel ini.
Belum Ada Komentar
Jadilah pembaca pertama yang memulai diskusi menarik atau bertanya seputar materi artikel ini!