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

React Custom Hooks & Fetch API: Pola Bersih Tangani Loading, Error, & Race Condition

Juan Mths
Juan Mths
Chief Technology Officer & Administrator
Ilustrasi React Custom Hooks & Fetch API: Pola Bersih Tangani Loading, Error, & Race Condition

Setelah memahami dasar useState dan useEffect pada panduan dasar React JS, tantangan berikutnya hampir selalu sama: mengambil data dari API di banyak halaman tanpa mengulang kode loading, error, dan try/catch berkali-kali. Lebih penting lagi, memanggil fetch() secara naif di dalam useEffect menyimpan jebakan halus bernama race condition.

1. Mengapa Fetch Biasa di useEffect Rawan Race Condition?

Bayangkan pengguna mengetik "la" lalu sepersekian detik kemudian melanjutkannya menjadi "laravel" pada kotak pencarian. Aplikasi mengirim dua permintaan jaringan secara berurutan:

  1. Permintaan pertama (?q=la) memakan waktu 900 ms karena datanya besar.
  2. Permintaan kedua (?q=laravel) lebih spesifik sehingga selesai dalam 200 ms dan langsung tampil di layar.
  3. 700 ms kemudian, permintaan pertama yang terlambat akhirnya tiba dan menimpa hasil "laravel" di layar dengan hasil usang "la".

Masalah ini tidak terlihat di localhost yang super cepat, tetapi sangat sering terjadi pada koneksi jaringan seluler pengguna di dunia nyata. Solusi standar browser yang ringan adalah membatalkan permintaan sebelumnya menggunakan AbortController di fungsi cleanup useEffect.

2. Membangun Custom Hook useFetch yang Dapat Dipakai Ulang

Custom Hook di React hanyalah fungsi JavaScript biasa yang namanya diawali kata use dan memanggil Hook bawaan React di dalamnya. Berikut implementasi src/hooks/useFetch.js yang menangani status loading, pengecekan status HTTP non-2xx, dan pembatalan request otomatis:

// src/hooks/useFetch.js
import { useState, useEffect } from 'react';

export function useFetch(url) {
  const [data, setData] = useState(null);
  const [loading, setLoading] = useState(false);
  const [error, setError] = useState(null);

  useEffect(() => {
    if (!url) {
      setData(null);
      setLoading(false);
      setError(null);
      return;
    }

    const controller = new AbortController();

    async function loadData() {
      setLoading(true);
      setError(null);

      try {
        const response = await fetch(url, { signal: controller.signal });

        // Ingat: fetch() tidak otomatis melempar error untuk HTTP 404 atau 500
        if (!response.ok) {
          throw new Error(`Permintaan gagal dengan status HTTP ${response.status}`);
        }

        const json = await response.json();
        setData(json);
      } catch (err) {
        if (err.name === 'AbortError') {
          return; // Abaikan pembatalan yang disengaja
        }
        setError(err.message || 'Terjadi kesalahan saat memuat data.');
      } finally {
        if (!controller.signal.aborted) {
          setLoading(false);
        }
      }
    }

    loadData();

    // Cleanup: batalkan permintaan lama jika url berubah atau komponen di-unmount
    return () => controller.abort();
  }, [url]);

  return { data, loading, error };
}

Perhatikan pemeriksaan if (!response.ok) di atas. Berbeda dengan Axios, fetch() hanya masuk ke blok catch apabila jaringan benar-benar putus atau request dibatalkan—status 404 Not Found dan 500 Internal Server Error tetap dianggap resolved kecuali kita mengecek response.ok secara eksplisit.

3. Menambahkan Custom Hook useDebounce untuk Pencarian

Agar aplikasi tidak menembak API pada setiap satu huruf ketikan, padukan useFetch dengan hook kecil useDebounce:

// src/hooks/useDebounce.js
import { useState, useEffect } from 'react';

export function useDebounce(value, delay = 350) {
  const [debounced, setDebounced] = useState(value);

  useEffect(() => {
    const timer = setTimeout(() => setDebounced(value), delay);
    return () => clearTimeout(timer);
  }, [value, delay]);

  return debounced;
}

4. Penerapan pada Komponen Pencarian Artikel

Sekarang komponen tampilan menjadi sangat bersih karena seluruh kerumitan jaringan dan pembatalan request sudah terisolasi di dalam dua Custom Hooks tersebut:

import { useState } from 'react';
import { useFetch } from '../hooks/useFetch';
import { useDebounce } from '../hooks/useDebounce';

export default function ArticleSearch() {
  const [query, setQuery] = useState('');
  const debouncedQuery = useDebounce(query.trim(), 350);

  const endpoint = debouncedQuery
    ? `/api/search?q=${encodeURIComponent(debouncedQuery)}`
    : null;

  const { data: results, loading, error } = useFetch(endpoint);

  return (
    <section>
      <label htmlFor="cari-artikel">Cari Artikel</label>
      <input
        id="cari-artikel"
        type="search"
        value={query}
        onChange={(e) => setQuery(e.target.value)}
        placeholder="Ketik topik, misalnya Laravel atau CSS..."
      />

      {loading && <p>Mencari artikel...</p>}
      {error && <p role="alert">{error}</p>}

      {!loading && !error && results && (
        results.length > 0 ? (
          <ul>
            {results.map((item) => (
              <li key={item.slug}>
                <a href={item.url}>{item.title}</a>
              </li>
            ))}
          </ul>
        ) : (
          <p>Tidak ada hasil untuk "{debouncedQuery}".</p>
        )
      )}
    </section>
  );
}

Kapan Custom Hook Cukup dan Kapan Harus Memakai TanStack Query?

Kebutuhan Aplikasi Custom Hook useFetch TanStack Query / SWR
Widget pencarian / beberapa endpoint sederhana Ideal (nol dependensi tambahan). Berlebihan untuk kebutuhan kecil.
Caching lintas halaman & deduplikasi request Harus membangun cache manual sendiri. Tersedia bawaan dengan invalidasi cache otomatis.
Optimistic update & retry otomatis Cukup rumit ditulis manual. Sangat matang untuk aplikasi SPA/dashboard besar.

Memahami pola AbortController dan useFetch dari dasar memastikan Anda mengerti persis apa yang terjadi di balik layar sebelum memutuskan menambahkan pustaka server-state eksternal.

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!