React.js Diterbitkan: • Diperbarui: • 4 menit baca • 5 views

Error Boundary & Penanganan Form Kompleks di React: Mencegah Layar Putih (White Screen) di Produksi

Juan Mths
Juan Mths
Chief Technology Officer & Administrator
Ilustrasi 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).

Diagram 4 lapisan resiliensi React mulai dari validasi null safety, ErrorBoundary per widget, tombol pemulihan reset, hingga penanganan error form asinkron
Kombinasi Error Boundary per fitur untuk kegagalan render sinkron serta try/catch di dalam handler asinkron menjaga halaman React tetap berfungsi walau salah satu bagian bermasalah.

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 onClick atau onSubmit.
  • 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

0

Sampaikan pertanyaan teknis, masukan, atau feedback Anda seputar artikel ini.

Tulis Komentar
* Tautan dalam komentar otomatis diamankan dengan atribut rel="nofollow ugc". Maks 2.000 karakter
Komentar langsung terbit setelah lolos filter spam.

Belum Ada Komentar

Jadilah pembaca pertama yang memulai diskusi menarik atau bertanya seputar materi artikel ini!