DOMException [TimeoutError]: The operation was aborted due to timeout
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
const r = await fetch(url, { signal: AbortSignal.timeout(5) });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
const semnal = AbortSignal.timeout(3000); // creat o dată
async function ia(url) {
return fetch(url, { signal: semnal });
}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
const r = await fetch(url, { signal: AbortSignal.timeout(2000) });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ă 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.
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();Raport: 42 comenzi, 3150 lei
Indiciu
AbortSignal.timeout primește milisecunde: 2 secunde înseamnă 2000.
Reparația
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(2000); // limita: 2 secunde, în milisecunde
console.log(await genereazaRaport(semnal));
}
main();De ce merge
AbortSignal.timeout(2) expiră după 2 milisecunde, mult înainte ca raportul de 100 ms să fie gata, deci throwIfAborted() aruncă TimeoutError. Cu 2000 (2 secunde în milisecunde), semnalul e încă valid când se termină calculul, iar raportul e întors. Aceeași regulă se aplică la fetch(url, { signal: AbortSignal.timeout(2000) }).
Alte forme ale mesajului
TimeoutError: The operation was aborted due to timeoutTypeError: fetch failed [cause]: DOMException [TimeoutError]: The operation was aborted due to timeoutDOMException [AbortError]: This operation was abortedAbortError: 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
TimeoutErrorseparat ș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
TypeError [ERR_INVALID_ARG_TYPE]: The "options.signal" property must be an instance of AbortSignal. Received an instance of AbortController Ai dat opțiunii signal obiectul AbortController în loc de semnalul lui. Scrie { signal: controller.signal }: controller-ul e telecomanda (are abort()), iar semnalul e ce primesc funcțiile care pot fi anulate. Error: connect ECONNREFUSED 127.0.0.1:3000 Programul tău încearcă să se conecteze la un server care nu ascultă la adresa și portul acela: serverul nu e pornit, s-a oprit sau folosești alt port. Pornește serverul (sau baza de date) și verifică portul din URL. Cu fetch, eroarea apare ca TypeError: fetch failed, cu ECONNREFUSED în cause. UnhandledPromiseRejection: This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). The promise rejected with the reason "Stoc insuficient". O promisiune a fost respinsă și nimeni nu a tratat eroarea: lipsește try/catch în jurul lui await sau .catch() la final. Din Node 15, o respingere netratată oprește programul. Adaugă try/catch (sau .catch) și respinge cu new Error(...), nu cu un text. Î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.
