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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
AbortController îți permite să anulezi o operație asincronă: fetch(url, { signal: controller.signal }) și apoi controller.abort(). Când semnalul e anulat, promisiunea operației e respinsă cu o DOMException cu numele AbortError. Textul diferă după mediu: în Chrome signal is aborted without reason, în Node This operation was aborted, în versiuni mai vechi de Chrome The user aborted a request.
Două situații:
- anulare voită (utilizatorul a schimbat pagina, a tastat altă căutare): nu e o eroare reală, dar trebuie prinsă, altfel apare ca
Uncaught (in promise) AbortError; - anulare accidentală: un singur controller refolosit. După
abort(), semnalul rămâne anulat pentru totdeauna, iar oricefetchnou cu el e respins imediat.
Tiparul corect pentru „anulează cererea anterioară”: controller.abort(); controller = new AbortController(); și abia apoi cererea nouă cu controller.signal. Dacă ai dat un motiv (abort("Pagină închisă")), eroarea primită e chiar acel motiv.
De ce apare: cauzele frecvente
1Controller refolosit după abort
controller.abort();
const r = await fetch(url, { signal: controller.signal });controller.abort();
controller = new AbortController();
const r = await fetch(url, { signal: controller.signal });Un semnal anulat nu mai poate fi „reactivat”; cererea nouă are nevoie de un controller nou.
2Anulare voită, netratată
useEffect(() => {
const c = new AbortController();
fetch(url, { signal: c.signal }).then(setDate);
return () => c.abort();
}, [url]);useEffect(() => {
const c = new AbortController();
fetch(url, { signal: c.signal }).then(setDate).catch((e) => {
if (e.name !== "AbortError") throw e;
});
return () => c.abort();
}, [url]);La demontarea componentei cererea se anulează; eroarea așteptată se ignoră explicit.
3abort() apelat prea devreme
const c = new AbortController();
c.abort();
await fetch(url, { signal: c.signal });const c = new AbortController();
const t = setTimeout(() => c.abort(), 5000);
await fetch(url, { signal: c.signal });
clearTimeout(t);Anularea trebuie să vină doar când operația chiar trebuie oprită.
Repară eroarea, direct în pagină
Funcția cauta anulează căutarea anterioară înainte să pornească una nouă, dar și noua căutare eșuează: AbortError: signal is aborted without reason (în Node: This operation was aborted). Repară funcția ca programul să afișeze Rezultat pentru js: 3 cursuri.
function descarca(text, signal) {
return new Promise((resolve, reject) => {
signal.throwIfAborted();
const t = setTimeout(() => resolve(`${text}: 3 cursuri`), 20);
signal.addEventListener("abort", () => {
clearTimeout(t);
reject(signal.reason);
});
});
}
let controller = new AbortController();
async function cauta(text) {
controller.abort();
const rezultat = await descarca(text, controller.signal);
console.log(`Rezultat pentru ${rezultat}`);
}
cauta("js");Rezultat pentru js: 3 cursuri
Indiciu
După abort(), semnalul vechi rămâne anulat; noua căutare are nevoie de un controller nou.
Reparația
function descarca(text, signal) {
return new Promise((resolve, reject) => {
signal.throwIfAborted();
const t = setTimeout(() => resolve(`${text}: 3 cursuri`), 20);
signal.addEventListener("abort", () => {
clearTimeout(t);
reject(signal.reason);
});
});
}
let controller = new AbortController();
async function cauta(text) {
controller.abort();
controller = new AbortController();
const rezultat = await descarca(text, controller.signal);
console.log(`Rezultat pentru ${rezultat}`);
}
cauta("js");De ce merge
controller.abort() anulează definitiv semnalul controllerului, iar descarca (la fel ca fetch) respinge imediat orice operație care primește un semnal deja anulat. Codul refolosea același controller și își anula chiar căutarea nouă. Cu controller = new AbortController() după abort(), căutarea veche e oprită, iar cea nouă primește un semnal curat și se termină normal.
Alte forme ale mesajului
DOMException [AbortError]: This operation was abortedAbortError: The user aborted a request.AbortError: The operation was aborted.Uncaught (in promise) AbortError: signal is aborted without reason
Cum o eviți pe viitor
- Creează un
AbortControllernou pentru fiecare cerere pe care vrei s-o poți anula. - În
catch, tratează separate.name === "AbortError"și nu-l afișa ca eroare utilizatorului. - Dă un motiv la anulare (
controller.abort("căutare nouă")), ca să știi de unde vine. - Pentru limite de timp, folosește
AbortSignal.timeout(ms)în loc de controller manual.
Întrebări frecvente
Cum deosebesc o anulare de o eroare de rețea?
Verifică e.name: anularea are AbortError (sau TimeoutError la AbortSignal.timeout), iar o eroare de rețea la fetch e de obicei TypeError: Failed to fetch.
De ce în React primesc eroarea de două ori în dezvoltare?
În Strict Mode, React montează și demontează efectele de două ori în dezvoltare, deci prima cerere e anulată intenționat. E normal; prinde AbortError și ignoră-l.
Erori înrudite
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"). 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.
