TimeoutError: signal timed out
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
await fetch(url, { signal: AbortSignal.timeout(5) });await fetch(url, { signal: AbortSignal.timeout(5000) });Valoarea e în milisecunde: 5 ms nu ajung pentru nicio cerere de rețea.
2Timeout netratat
const r = await fetch(url, { signal: AbortSignal.timeout(3000) });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ă
await incarcaRaport({ signal: AbortSignal.timeout(1000) });await incarcaRaport({ signal: AbortSignal.timeout(30000) });Rapoartele sau încărcările mari au nevoie de limite mai mari decât o cerere simplă.
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.
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();Raport: 12 comenzi
Indiciu
AbortSignal.timeout primește milisecunde.
Reparația
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(2000));
console.log(`Raport: ${raport}`);
}
main();De ce merge
AbortSignal.timeout(2) înseamnă 2 milisecunde, nu 2 secunde. Raportul are nevoie de aproximativ 50 ms, deci semnalul expira primul, iar promisiunea era respinsă cu motivul semnalului, o TimeoutError. Cu AbortSignal.timeout(2000) limita e de 2 secunde, raportul se termină la timp și promisiunea se rezolvă cu textul lui.
Alte forme ale mesajului
DOMException [TimeoutError]: The operation was aborted due to timeoutTimeoutError: 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
TimeoutErrorseparat 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
AbortError: signal is aborted without reason O operație (de obicei fetch) a primit un AbortSignal care era deja anulat sau a fost anulat cu controller.abort() în timp ce aștepta. Dacă anularea e voită, prinde eroarea (if (e.name === "AbortError") return). Dacă nu, folosește un AbortController nou pentru fiecare cerere. Uncaught (in promise) Error: Request failed O promisiune a fost respinsă (o funcție `async` a aruncat o eroare sau o cerere a eșuat), iar nimeni nu a prins eroarea cu `try...catch` sau `.catch()`. Pune `await` în interiorul unui `try...catch`, sau adaugă `.catch()` la apelul funcției `async`. AggregateError: All promises were rejected `Promise.any` a eșuat pentru că toate promisiunile primite au fost respinse (sau lista era goală). Erorile individuale sunt în `e.errors`. Prinde eroarea cu `try...catch` sau `.catch` și citește `e.errors` ca să vezi de ce a picat fiecare sursă. Î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.
