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`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când o funcție async aruncă o eroare, eroarea nu oprește imediat programul, ci respinge promisiunea returnată de funcție. Dacă nimeni nu tratează acea respingere (cu await într-un try...catch sau cu .catch()), browserul afișează Uncaught (in promise) urmat de eroarea originală, aici Error: Request failed.
Partea de după (in promise) e cea importantă: este eroarea reală (un TypeError, o eroare de rețea, o eroare aruncată de tine). Citește-o și stiva ei ca de obicei.
În Node.js, o respingere netratată oprește procesul și afișează eroarea (sau [UnhandledPromiseRejection: ...] dacă motivul nu e un obiect Error).
Cauze tipice: apelezi o funcție async fără await și fără .catch(); ai try...catch în jurul apelului, dar fără await, deci eroarea apare după ce try s-a terminat; respingi cu Promise.reject(...) fără ca cineva să asculte; Promise.all cu o promisiune care eșuează.
De ce apare: cauzele frecvente
1try...catch fără await
try {
incarcaDate();
} catch (e) {
console.log("Eroare:", e.message);
}try {
await incarcaDate();
} catch (e) {
console.log("Eroare:", e.message);
}Fără await, apelul returnează imediat o promisiune, iar try se termină înainte ca eroarea să apară.
2Funcție async apelată fără tratare
async function main() {
throw new Error("Request failed");
}
main();async function main() {
throw new Error("Request failed");
}
main().catch((e) => console.log("Eroare:", e.message));.catch() pe promisiunea returnată de main prinde orice eroare din interior.
3Promise.all cu o promisiune care eșuează
const rezultate = await Promise.all([p1, p2, p3]);const rezultate = await Promise.allSettled([p1, p2, p3]);
const reusite = rezultate.filter((r) => r.status === "fulfilled");Promise.all eșuează la prima respingere. Promise.allSettled așteaptă toate și îți spune care au reușit.
Repară eroarea, direct în pagină
Funcția de mai jos simulează o cerere către server care eșuează. Programul are un try...catch, dar se oprește totuși cu eroarea netratată Error: Request failed (în browser: Uncaught (in promise) Error: Request failed). Repară funcția main ca eroarea să fie prinsă și programul să afișeze Încerc..., Nu am putut încărca: Request failed și Gata.
async function incarcaProduse() {
await new Promise((resolve) => setTimeout(resolve, 10));
throw new Error("Request failed");
}
async function main() {
console.log("Încerc...");
try {
incarcaProduse();
} catch (e) {
console.log(`Nu am putut încărca: ${e.message}`);
}
}
main();Încerc... Nu am putut încărca: Request failed Gata
Indiciu
try...catch prinde erorile unei promisiuni doar dacă aștepți promisiunea cu await.
Reparația
async function incarcaProduse() {
await new Promise((resolve) => setTimeout(resolve, 10));
throw new Error("Request failed");
}
async function main() {
console.log("Încerc...");
try {
await incarcaProduse();
} catch (e) {
console.log(`Nu am putut încărca: ${e.message}`);
}
console.log("Gata");
}
main();De ce merge
Fără await, incarcaProduse() returnează imediat o promisiune, blocul try se termină fără nicio eroare, iar 10 ms mai târziu promisiunea e respinsă fără ca nimeni să o mai aștepte. Cu await, main se oprește la acel rând până la terminarea promisiunii, iar respingerea devine o excepție obișnuită, prinsă de catch. După tratarea erorii, programul continuă și afișează Gata.
Alte forme ale mesajului
Uncaught (in promise) TypeError: Failed to fetchUncaught (in promise) TypeError: Cannot read properties of undefined (reading 'data')[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().]Unhandled Promise Rejection: Error: Request failed
Cum o eviți pe viitor
- Orice apel
asyncfie areawait(într-o funcție cutry...catch), fie are.catch(). - Pune un
try...catchîn funcția principală, care afișează un mesaj clar pentru utilizator. - Folosește
Promise.allSettledcând unele operații pot eșua fără ca restul să fie compromise. - În browser, un handler global
window.addEventListener("unhandledrejection", ...)e util pentru raportarea erorilor, nu ca înlocuitor al tratării locale.
Întrebări frecvente
Am pus try...catch, de ce primesc tot eroarea?
Probabil lipsește await în fața apelului din try. Fără el, eroarea apare mai târziu, după ce blocul try s-a terminat.
Ce eroare e de fapt?
Cea scrisă după (in promise). Uncaught (in promise) îți spune doar că nu a fost prinsă; cauza reală e eroarea care urmează, cu stiva ei.
Erori înrudite
SyntaxError: await is only valid in async functions and the top level bodies of modules Ai folosit `await` într-o funcție care nu e marcată `async` (des: într-un callback de `forEach` sau `map`) sau la nivelul de sus al unui script care nu e modul. Adaugă `async` funcției care conține `await`, sau pune codul într-o funcție `async function main() { ... }` și apeleaz-o. SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON Ai încercat să citești ca JSON un răspuns care este de fapt o pagină HTML, de obicei o pagină de eroare 404 sau 500, ori pagina principală a aplicației întoarsă pentru o adresă greșită. Verifică URL-ul cererii și `raspuns.ok` înainte de `.json()`, și uită-te la răspuns în tab-ul Network. TypeError: Cannot read properties of undefined (reading 'nume') Încerci să citești o proprietate (aici `nume`) dintr-o valoare care este `undefined`, adică dintr-un obiect care nu există. De obicei un element de tablou care lipsește, o proprietate scrisă greșit sau o funcție care nu returnează nimic. Află de ce valoarea e `undefined` sau folosește `?.` dacă lipsa e normală. Î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.
