Cara retry fetch request gagal di JavaScript yang benar adalah membungkus fetch() di dalam loop async/await dengan batas maksimal 3 kali dan jeda 1 sampai 2 detik. Kesalahan yang sering terjadi adalah mengulang request tanpa henti atau mengulang semua status error, padahal hanya network error dan 5xx yang layak diulang.
Kenapa Fetch Perlu Retry Terbatas
fetch() hanya reject saat network error, seperti koneksi putus atau DNS gagal. Status 404 atau 500 tetap dianggap resolve, jadi kamu harus cek response.ok sendiri.
- Jalankan retry saat: TypeError network gagal, request timeout, status 500, 502, 503, 504.
- Langsung berhenti saat: status 400, 401, 403, 404, JSON tidak valid, error CORS.
- Batasi maksimal 3 kali percobaan dengan jeda 1000 ms agar tidak membebani server.
Pola Retry Fetch dengan Async Await dan Delay
Ikuti alur ini untuk retry yang aman di browser:
- Buat loop for sebanyak jumlah retries.
- Panggil fetch() di dalam try dan cek response.ok.
- Jika gagal dan masih ada sisa percobaan, tunggu dengan setTimeout.
- Jika semua gagal, lempar error terakhir ke pemanggil.
async function retryFetch(url, retries = 3, delay = 1000) {
let lastError;
for (let i = 0; i < retries; i++) {
try {
const res = await fetch(url);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
return await res.json();
} catch (err) {
lastError = err;
if (i < retries - 1) {
await new Promise(r => setTimeout(r, delay));
}
}
}
throw lastError;
}
Kode ini menyimpan error terakhir lalu menunggu sebelum mencoba lagi. Respon sukses langsung dikembalikan sebagai JSON, respon gagal dilempar agar bisa di-retry. Bagian setTimeout memberi jeda supaya API publik tidak terkena spam request.
Tabel Keputusan Retry agar Tidak Spam API
| Kondisi Gagal | Retry atau Stop | Catatan |
|---|---|---|
| Offline / timeout | Retry | Cek navigator.onLine dulu |
| 404 Not Found | Stop | URL salah, ulang tidak membantu |
| 500 / 503 | Retry | Server sementara bermasalah |
- Jangan retry tanpa counter, request bisa jalan ratusan kali.
- Jangan retry error CORS, masalahnya ada di konfigurasi server.
- Jangan retry 401 tanpa refresh token lebih dulu.
Untuk polling, hentikan dengan counter atau AbortController. Panggil controller.abort() saat pengguna pindah halaman atau jumlah percobaan habis.
FAQ
Berapa kali retry fetch yang aman untuk API publik?
Maksimal 3 kali dengan jeda 1 detik agar tidak dianggap spam.
Apakah response 404 perlu di-retry ulang?
Tidak, 404 berarti resource tidak ada dan pengulangan tidak mengubah hasil.
Kapan memakai exponential backoff saat retry fetch?
Pakai saat API sering 429 atau 503, misalnya jeda 1 detik, 2 detik, lalu 4 detik.