Cara mengatasi fetch API network error JavaScript paling cepat adalah memastikan request benar-benar sampai ke server, bukan sekadar koneksi internet aktif. Error TypeError: Failed to fetch berarti browser membatalkan request sebelum mendapat respons HTTP. Periksa status online, URL endpoint, protokol HTTPS, lalu tangani response.ok di dalam try...catch.
Penyebab Fetch Api Network Error di Browser
Fetch tidak reject untuk status 404 atau 500. Fetch reject saat tidak ada respons sama sekali. Bedakan empat kasus ini agar solusinya tidak salah sasaran.
- Network error murni: perangkat offline, DNS gagal, server mati, atau koneksi terputus.
- HTTP error: server menjawab 404, 500, 403. Ini bukan network error, cek lewat
response.ok. - CORS: server tidak mengizinkan origin kamu, browser memblokir respons.
- JSON parse error: respons ternyata HTML atau teks kosong, lalu
response.json()gagal. - Abort/timeout: request dibatalkan
AbortControlleratau halaman pindah sebelum selesai.
| Error/Kondisi | Penyebab | Solusi |
|---|---|---|
| Failed to fetch | Offline, DNS, server down | Cek navigator.onLine dan URL |
| CORS policy blocked | Header server menolak origin | Perbaiki konfigurasi server |
| Unexpected token di json() | Respons bukan JSON | Cek Content-Type dulu |
Langkah Memperbaiki Fetch yang Gagal Terhubung
Ikuti urutan ini dari yang paling sering jadi biang masalah.
1. Pastikan browser online dengan navigator.onLine.
2. Salin URL ke tab baru, pastikan endpoint hidup dan memakai HTTPS.
3. Buka DevTools tab Network, lihat apakah request berstatus (failed) atau ada status HTTP.
4. Tambahkan pengecekan response.ok dan bungkus dengan try...catch.
async function ambilData() {
try {
const res = await fetch("https://api.example.com/data");
if (!res.ok) {
throw new Error("HTTP error: " + res.status);
}
const data = await res.json();
console.log(data);
} catch (err) {
console.error("Fetch gagal:", err.message);
}
}
Kode di atas memisahkan tiga kegagalan. Blok catch menangkap network error dan abort. Cek res.ok menangkap HTTP error 404/500. Pemanggilan res.json() hanya jalan setelah status dipastikan aman.
Cara Mencegah Network Error Terulang
Gunakan timeout agar request macet tidak menggantung selamanya. Batasi retry maksimal 2 sampai 3 kali untuk error jaringan, jangan untuk 400 atau 401.
const controller = new AbortController();
setTimeout(() => controller.abort(), 8000);
await fetch(url, { signal: controller.signal });
- Validasi
Content-Typeberisiapplication/jsonsebelum parsing. - Tampilkan status loading dan tombol coba lagi saat
navigator.onLinefalse. - Catat error ke console dengan URL dan waktu untuk debugging.
- Minta backend mengaktifkan CORS hanya untuk domain yang dibutuhkan.
FAQ
Apakah fetch reject saat status 404 atau 500?
Tidak. Fetch tetap resolve, kamu harus memeriksa response.ok atau response.status sendiri.
Kenapa network error muncul padahal internet aktif?
Umumnya karena CORS ditolak server, URL salah, server down, atau request dibatalkan sebelum selesai.