...
Eroare JavaScript · Promisiuni și async/await

TimeoutError: signal timed out

Pe scurt

Operația a folosit AbortSignal.timeout(ms) și nu s-a terminat în timpul dat, așa că a fost anulată. Fie limita e prea mică (ai pus 10 în loc de 10000 de milisecunde), fie serverul răspunde greu. Mărește limita realist și prinde eroarea cu if (e.name === "TimeoutError").

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

AbortSignal.timeout(ms) creează un semnal care se anulează singur după numărul de milisecunde dat. Îl dai unei operații (fetch(url, { signal: AbortSignal.timeout(5000) })), iar dacă operația nu se termină la timp, e respinsă cu o DOMException numită TimeoutError. Mesajul: signal timed out în Chrome, The operation was aborted due to timeout în Node, The operation timed out. în Firefox.

Spre deosebire de AbortError (anulare manuală), TimeoutError îți spune că s-a depășit timpul. Cauze reale:

  • limită dată în secunde în loc de milisecunde (timeout(5) = 5 ms);
  • o limită potrivită local, dar prea mică pentru rețeaua sau serverul din producție;
  • o operație care chiar e blocată (server căzut, cerere fără răspuns).

În catch, tratează-l separat: afișează un mesaj de tipul „Serverul răspunde greu, încearcă din nou” sau reîncearcă de câteva ori, cu pauză între încercări.

De ce apare: cauzele frecvente

1Secunde în loc de milisecunde

Greșit
JavaScript
await fetch(url, { signal: AbortSignal.timeout(5) });
Corect
JavaScript
await fetch(url, { signal: AbortSignal.timeout(5000) });

Valoarea e în milisecunde: 5 ms nu ajung pentru nicio cerere de rețea.

2Timeout netratat

Greșit
JavaScript
const r = await fetch(url, { signal: AbortSignal.timeout(3000) });
Corect
JavaScript
try {
  const r = await fetch(url, { signal: AbortSignal.timeout(3000) });
} catch (e) {
  if (e.name === "TimeoutError") afiseaza("Serverul răspunde greu.");
  else throw e;
}

Depășirea timpului e un caz normal pe care utilizatorul trebuie să-l vadă explicat.

3Limită prea strânsă pentru o operație lungă

Greșit
JavaScript
await incarcaRaport({ signal: AbortSignal.timeout(1000) });
Corect
JavaScript
await incarcaRaport({ signal: AbortSignal.timeout(30000) });

Rapoartele sau încărcările mari au nevoie de limite mai mari decât o cerere simplă.

Repară tu

Repară eroarea, direct în pagină

Programul descarcă un raport care durează în jur de 50 de milisecunde și îi dă o limită de timp, dar se oprește cu TimeoutError: signal timed out (în Node: The operation was aborted due to timeout). Programatorul voia o limită de 2 secunde. Repară limita ca programul să afișeze Raport: 12 comenzi.

Codul care dă eroarea
JavaScript
function descarcaRaport(signal) {
  return new Promise((resolve, reject) => {
    const t = setTimeout(() => resolve("12 comenzi"), 50);
    signal.addEventListener("abort", () => {
      clearTimeout(t);
      reject(signal.reason);
    });
  });
}

async function main() {
  const raport = await descarcaRaport(AbortSignal.timeout(2));
  console.log(`Raport: ${raport}`);
}

main();
După reparație, programul afișează
Raport: 12 comenzi
Indiciu

AbortSignal.timeout primește milisecunde.

Alte forme ale mesajului

  • DOMException [TimeoutError]: The operation was aborted due to timeout
  • TimeoutError: The operation timed out.
  • Uncaught (in promise) TimeoutError: signal timed out

Cum o eviți pe viitor

  • Scrie limitele cu unitate clară: const TIMEOUT_MS = 5000.
  • Alege limite realiste pentru fiecare tip de operație (căutare, încărcare fișier, raport).
  • Prinde TimeoutError separat de alte erori și oferă reîncercare.
  • Combină timeout-ul cu anularea manuală prin AbortSignal.any([c.signal, AbortSignal.timeout(5000)]).

Întrebări frecvente

E diferit de AbortError?

Da: AbortError înseamnă că cineva a apelat abort(), iar TimeoutError că a expirat timpul dat lui AbortSignal.timeout. Le deosebești după e.name.

fetch are un timeout implicit?

Nu există o limită standard pe care s-o controlezi; browserul poate aștepta foarte mult. De aceea se folosește AbortSignal.timeout.

Erori înrudite

← Toate erorile JavaScript

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață JavaScript de la zero, cu exerciții la fiecare lecție

Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.