...
Eroare Node.js · Asincron: callback-uri, promisiuni și timere

DOMException [TimeoutError]: The operation was aborted due to timeout

Pe scurt

Un AbortSignal.timeout(ms) a expirat înainte să se termine operația (de obicei un fetch), iar operația a fost anulată. Verifică dacă limita e în milisecunde (5000, nu 5), mărește-o dacă serviciul e lent și prinde eroarea cu catch, verificând err.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ă ms milisecunde. Când îl dai lui fetch(url, { signal }) sau îl verifici cu signal.throwIfAborted(), operația se oprește cu un DOMException al cărui name este TimeoutError.

Mesajul The operation was aborted due to timeout înseamnă deci „ai pus o limită de timp și a trecut”. Nu e o eroare de rețea: serverul poate fi pornit, dar a răspuns prea încet pentru limita ta.

Cauzele obișnuite: limita scrisă în secunde (AbortSignal.timeout(5) = 5 ms), o limită prea mică pentru un serviciu lent sau un semnal creat o singură dată la pornire și refolosit pentru toate cererile (expiră o dată și apoi anulează tot). Un AbortController.abort() manual dă alt mesaj: AbortError: This operation was aborted.

De ce apare: cauzele frecvente

1Limita scrisă în secunde

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

Argumentul e în milisecunde: 5 înseamnă 5 ms, prea puțin pentru orice cerere reală.

2Semnal refolosit între cereri

Greșit
JavaScript
const semnal = AbortSignal.timeout(3000); // creat o dată
async function ia(url) {
  return fetch(url, { signal: semnal });
}
Corect
JavaScript
async function ia(url) {
  return fetch(url, { signal: AbortSignal.timeout(3000) });
}

Un semnal expirat rămâne expirat. Fiecare cerere are nevoie de propriul semnal.

3Timeout netratat

Greșit
JavaScript
const r = await fetch(url, { signal: AbortSignal.timeout(2000) });
Corect
JavaScript
try {
  const r = await fetch(url, { signal: AbortSignal.timeout(2000) });
} catch (err) {
  if (err.name === "TimeoutError") console.log("Serviciul răspunde greu");
  else throw err;
}

Timeout-ul e o situație normală într-o aplicație: tratează-l separat de celelalte erori.

Repară tu

Repară eroarea, direct în pagină

Funcția genereazaRaport durează cam 100 ms, iar codul o oprește dacă trece de limita stabilită cu AbortSignal.timeout. Cine a scris codul a crezut că valoarea e în secunde și a pus 2, așa că raportul e anulat cu The operation was aborted due to timeout. Pune limita corectă de 2 secunde, ca programul să afișeze raportul.

Codul care dă eroarea
JavaScript
const { setTimeout: asteapta } = require("timers/promises");

async function genereazaRaport(semnal) {
  await asteapta(100); // calcule lente
  semnal.throwIfAborted();
  return "Raport: 42 comenzi, 3150 lei";
}

async function main() {
  const semnal = AbortSignal.timeout(2); // limita: 2 secunde
  console.log(await genereazaRaport(semnal));
}

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

AbortSignal.timeout primește milisecunde: 2 secunde înseamnă 2000.

Alte forme ale mesajului

  • TimeoutError: The operation was aborted due to timeout
  • TypeError: fetch failed [cause]: DOMException [TimeoutError]: The operation was aborted due to timeout
  • DOMException [AbortError]: This operation was aborted
  • AbortError: The operation was aborted

Cum o eviți pe viitor

  • Scrie limitele ca nume de constante cu unitatea: const TIMEOUT_MS = 5000;.
  • Creează un AbortSignal.timeout(...) nou pentru fiecare operație.
  • Prinde TimeoutError separat și decide: reîncerci, afișezi un mesaj sau folosești o valoare din cache.
  • Pentru mai multe condiții de oprire, combină semnalele cu AbortSignal.any([semnalUtilizator, AbortSignal.timeout(5000)]).

Întrebări frecvente

Care e diferența dintre TimeoutError și AbortError?

TimeoutError vine de la AbortSignal.timeout (a expirat timpul). AbortError vine de la un controller.abort() apelat de codul tău (de exemplu utilizatorul a anulat). Le deosebești după err.name.

Timer-ul lui AbortSignal.timeout ține programul pornit?

Nu. Timer-ul intern nu ține procesul Node în viață, deci programul se poate termina înainte să expire.

Erori înrudite

← Toate erorile Node.js

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ță Node.js de la zero, cu exerciții la fiecare lecție

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