Jangan Ulang Manual, Pakai Cara Retry Fetch Request Gagal Javascript Ini

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:

  1. Buat loop for sebanyak jumlah retries.
  2. Panggil fetch() di dalam try dan cek response.ok.
  3. Jika gagal dan masih ada sisa percobaan, tunggu dengan setTimeout.
  4. 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.