AbortError: signal is aborted without reason
O cerere fetch a fost anulată cu AbortController.abort(), de obicei de curățarea unui useEffect (la demontare, la schimbarea dependențelor sau la dubla montare din StrictMode). Nu e o eroare reală: în catch, ignoră erorile cu e.name === "AbortError" și afișează doar celelalte.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când dai lui fetch un signal de la un AbortController și apelezi controller.abort(), promisiunea cererii este respinsă cu un DOMException cu numele AbortError. Chrome îl afișează ca „signal is aborted without reason” (sau, în versiuni mai vechi, „The user aborted a request.”), Firefox ca „The operation was aborted.”.
În React, tiparul corect pentru cereri este exact acesta: efectul pornește cererea și o anulează în curățare. Curățarea rulează când componenta dispare, când se schimbă o dependență (de exemplu termenul căutat) și, în dezvoltare, cu StrictMode, imediat după prima montare: React 18 montează, demontează și montează din nou componentele ca să verifice efectele. Prima cerere este deci anulată mereu în dezvoltare.
Anularea este intenționată, așa că nu trebuie arătată utilizatorului. Problema apare doar când catch tratează orice eroare la fel și afișează „Eroare la încărcare” sau o trimite la un serviciu de monitorizare. Verifică e.name === "AbortError" și ieși din catch fără să faci nimic.
De ce apare: cauzele frecvente
1catch care afișează și anularea
fetch(url, { signal: ctrl.signal })
.then((r) => r.json())
.then(setDate)
.catch((e) => setEroare(e.message));fetch(url, { signal: ctrl.signal })
.then((r) => r.json())
.then(setDate)
.catch((e) => {
if (e.name === "AbortError") return;
setEroare(e.message);
});Anularea are numele AbortError și e ignorată; doar erorile reale ajung în pagină.
2Cu async/await
try {
const r = await fetch(url, { signal });
setDate(await r.json());
} catch (e) {
setEroare("Nu s-au putut încărca datele");
}try {
const r = await fetch(url, { signal });
setDate(await r.json());
} catch (e) {
if (e.name !== "AbortError") {
setEroare("Nu s-au putut încărca datele");
}
}Același filtru, scris în catch-ul blocului try.
3abort() apelat cu un motiv
return () => ctrl.abort();
// în consolă: AbortError: signal is aborted without reasonreturn () => ctrl.abort("componenta s-a demontat");
// în catch: e === "componenta s-a demontat" sau signal.abortedCu un motiv, promisiunea e respinsă cu acel motiv; verifică ctrl.signal.aborted ca să o recunoști.
Repară eroarea, direct în pagină
Căutarea de mai jos rulează în StrictMode și anulează cererea în curățarea efectului. Funcția cauta simulează un fetch cu signal. În pagină apare „AbortError: signal is aborted without reason”, deși rezultatele s-au încărcat. Repar-o ca #eroare să nu apară, iar lista să aibă 2 produse.
import { useState, useEffect, StrictMode } from "react";
const DATE = { ca: ["Cană", "Castron"] };
// Simulează fetch(url, { signal }): anularea respinge promisiunea cu un AbortError
function cauta(termen, signal) {
return new Promise((resolve, reject) => {
const t = setTimeout(() => resolve(DATE[termen] || []), 100);
signal.addEventListener("abort", () => {
clearTimeout(t);
reject(new DOMException("signal is aborted without reason", "AbortError"));
});
});
}
function Cautare() {
const [rezultate, setRezultate] = useState([]);
const [eroare, setEroare] = useState("");
useEffect(() => {
const ctrl = new AbortController();
cauta("ca", ctrl.signal)
.then(setRezultate)
.catch((e) => setEroare(e.name + ": " + e.message));
return () => ctrl.abort();
}, []);
return (
<div>
{eroare && <p id="eroare">{eroare}</p>}
<ul>
{rezultate.map((p) => <li key={p}>{p}</li>)}
</ul>
</div>
);
}
export default function App() {
return (
<StrictMode>
<Cautare />
</StrictMode>
);
}Indiciu
În catch, ieși imediat dacă e.name este "AbortError".
Reparația
import { useState, useEffect, StrictMode } from "react";
const DATE = { ca: ["Cană", "Castron"] };
// Simulează fetch(url, { signal }): anularea respinge promisiunea cu un AbortError
function cauta(termen, signal) {
return new Promise((resolve, reject) => {
const t = setTimeout(() => resolve(DATE[termen] || []), 100);
signal.addEventListener("abort", () => {
clearTimeout(t);
reject(new DOMException("signal is aborted without reason", "AbortError"));
});
});
}
function Cautare() {
const [rezultate, setRezultate] = useState([]);
const [eroare, setEroare] = useState("");
useEffect(() => {
const ctrl = new AbortController();
cauta("ca", ctrl.signal)
.then(setRezultate)
.catch((e) => {
if (e.name === "AbortError") return;
setEroare(e.name + ": " + e.message);
});
return () => ctrl.abort();
}, []);
return (
<div>
{eroare && <p id="eroare">{eroare}</p>}
<ul>
{rezultate.map((p) => <li key={p}>{p}</li>)}
</ul>
</div>
);
}
export default function App() {
return (
<StrictMode>
<Cautare />
</StrictMode>
);
}De ce merge
În dezvoltare, StrictMode montează componenta, o demontează și o montează din nou. Curățarea primei montări a apelat ctrl.abort(), prima cerere a fost respinsă cu AbortError, iar catch a afișat-o ca pe o eroare, deși a doua cerere a adus rezultatele.
Cu if (e.name === "AbortError") return;, anularea intenționată e ignorată. Erorile reale (rețea, server) ajung în continuare în #eroare, iar lista afișează rezultatele cererii care nu a fost anulată.
Alte forme ale mesajului
AbortError: The user aborted a request.AbortError: The operation was aborted.DOMException: The operation was aborted.Uncaught (in promise) DOMException: signal is aborted without reasonAbortError: Fetch is aborted
Cum o eviți pe viitor
- În fiecare
catchpentru o cerere anulabilă, ignorăAbortErrorînainte de orice altceva. - Nu dezactiva StrictMode ca să scapi de mesaj: el îți arată tocmai că efectele trebuie să se poată anula.
- Pune logica de cereri într-un hook propriu (
useFetch), cu anularea și filtrul scrise o singură dată. - Folosește
signal.aborteddacă vrei să verifici anularea și după ce promisiunea s-a terminat.
Întrebări frecvente
De ce văd eroarea doar în dezvoltare?
Din cauza StrictMode: React 18 montează componentele de două ori în dezvoltare, iar curățarea primei montări anulează prima cerere. În producție, cererea e anulată doar când chiar se demontează componenta sau se schimbă dependențele.
Trebuie să anulez cererile? Nu e mai simplu fără AbortController?
Fără anulare, un răspuns vechi poate sosi după unul nou și poate suprascrie datele (de exemplu la căutare). Anularea plus filtrul pentru AbortError rezolvă ambele probleme.
Erori înrudite
Warning: Can't perform a React state update on an unmounted component. This is a no-op, but it indicates a memory leak in your application. To fix, cancel all subscriptions and asynchronous tasks in a useEffect cleanup function. O cerere, un timer sau o abonare pornită de o componentă se termină după ce componenta a dispărut din pagină și încearcă să schimbe starea. Avertismentul e din React 17 (React 18 l-a scos), dar problema rămâne: oprește tot ce ai pornit în funcția de curățare a efectului (clearTimeout, abort, unsubscribe). TypeError: Failed to fetch Cererea fetch nu a primit niciun răspuns: serverul nu rulează, adresa e greșită (alt port, http/https) sau browserul a blocat-o (CORS). Verifică adresa în tab-ul Network și prinde eroarea cu .catch ca să afișezi un mesaj. Unexpected reserved word 'await'. Ai folosit await într-o funcție care nu e async, de obicei direct în callback-ul din useEffect sau într-un handler. Scrie o funcție async în interiorul efectului și apeleaz-o (const incarca = async () => {...}; incarca();), sau marchează handler-ul cu async. Învață React de la zero, cu exerciții la fiecare lecție
Curs React: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
