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:
- Permintaan pertama (
?q=la) memakan waktu 900 ms karena datanya besar. - Permintaan kedua (
?q=laravel) lebih spesifik sehingga selesai dalam 200 ms dan langsung tampil di layar. - 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
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!