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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul descrie exact cele două situații: ai aruncat o eroare într-o funcție async fără catch, sau ai respins o promisiune (reject(...)) fără .catch(). Promisiunea respinsă ajunge la final fără să o prindă nimeni, iar Node, începând cu versiunea 15, oprește procesul cu cod de ieșire 1.
Forma exactă din acest mesaj apare când motivul respingerii nu este un obiect Error, ci un text sau alt tip (throw "Stoc insuficient", reject("timeout")). Atunci Node nu are o stivă de apeluri de afișat și îți dă doar motivul. Dacă respingi cu new Error(...), vezi în schimb chiar eroarea, cu linia unde a apărut, ceea ce e mult mai util.
Ca să găsești locul, caută funcția async sau promisiunea care produce motivul afișat și urmărește unde e apelată fără await în try/catch sau fără .catch().
De ce apare: cauzele frecvente
1await fără try/catch
async function main() {
const comanda = await plaseazaComanda(7);
console.log(comanda);
}
main();async function main() {
try {
const comanda = await plaseazaComanda(7);
console.log(comanda);
} catch (err) {
console.log(`Eroare: ${err.message}`);
}
}
main();try/catch în jurul lui await prinde respingerea promisiunii, exact ca o excepție obișnuită.
2Promisiune fără .catch()
trimiteEmail(client).then(() => console.log("Trimis"));trimiteEmail(client)
.then(() => console.log("Trimis"))
.catch((err) => console.log(`Netrimis: ${err.message}`));Fiecare lanț .then() are nevoie de un .catch() la final.
3Respingere cu text în loc de Error
if (stoc < cantitate) throw "Stoc insuficient";if (stoc < cantitate) throw new Error("Stoc insuficient");Un obiect Error are mesaj și stivă de apeluri, deci vezi linia la care a apărut problema; un text nu are nimic din toate astea.
4Funcție async apelată în buclă, fără await
for (const id of ids) {
salveaza(id);
}await Promise.all(ids.map((id) => salveaza(id)));Promisiunile lansate și uitate nu sunt așteptate și nici tratate. Promise.all le așteaptă pe toate și îți dă prima eroare în catch.
Repară eroarea, direct în pagină
Funcția plaseazaComanda respinge comanda cu un text când stocul nu ajunge, iar nimeni nu tratează eroarea, așa că programul se oprește cu UnhandledPromiseRejection. Aruncă un obiect Error și prinde eroarea în main cu try/catch, ca programul să afișeze rezultatul pentru toate cele trei comenzi.
const stoc = { cafea: 5, ceai: 1 };
async function plaseazaComanda(produs, cantitate) {
if (stoc[produs] < cantitate) throw "Stoc insuficient";
stoc[produs] -= cantitate;
return `${cantitate} x ${produs}`;
}
async function main() {
for (const [produs, cantitate] of [["cafea", 2], ["ceai", 3], ["cafea", 1]]) {
const rezultat = await plaseazaComanda(produs, cantitate);
console.log(`Comandă plasată: ${rezultat}`);
}
}
main();Comandă plasată: 2 x cafea Comandă respinsă: Stoc insuficient pentru ceai Comandă plasată: 1 x cafea
Indiciu
Pune try/catch în jurul lui await plaseazaComanda(...), în interiorul buclei, ca o comandă eșuată să nu le oprească pe celelalte.
Reparația
const stoc = { cafea: 5, ceai: 1 };
async function plaseazaComanda(produs, cantitate) {
if (stoc[produs] < cantitate) throw new Error(`Stoc insuficient pentru ${produs}`);
stoc[produs] -= cantitate;
return `${cantitate} x ${produs}`;
}
async function main() {
for (const [produs, cantitate] of [["cafea", 2], ["ceai", 3], ["cafea", 1]]) {
try {
const rezultat = await plaseazaComanda(produs, cantitate);
console.log(`Comandă plasată: ${rezultat}`);
} catch (err) {
console.log(`Comandă respinsă: ${err.message}`);
}
}
}
main();De ce merge
O funcție async care aruncă o eroare întoarce o promisiune respinsă. await transformă respingerea înapoi într-o excepție, pe care o prinzi cu try/catch; fără el, respingerea urcă până în main(), care nu o tratează, și Node oprește procesul. Cu try/catch în buclă, comanda de ceai e respinsă, iar celelalte două merg mai departe. new Error(...) îți dă în plus mesajul în err.message și linia exactă în stivă.
Alte forme ale mesajului
[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 "timeout".] { code: 'ERR_UNHANDLED_REJECTION' }Error [ERR_UNHANDLED_REJECTION]UnhandledPromiseRejectionWarning: Unhandled promise rejection.Uncaught (in promise) Stoc insuficient
Cum o eviți pe viitor
- Pune
try/catchîn jurulawait-urilor care pot eșua, sau măcar în funcțiamain. - Termină fiecare lanț de promisiuni cu
.catch(). - Aruncă și respinge doar obiecte
Error:throw new Error("..."),reject(new Error("...")). - Ca plasă de siguranță, poți loga respingerile cu
process.on("unhandledRejection", ...), dar repară cauza, nu te baza pe ea.
Întrebări frecvente
De ce în versiunile vechi de Node era doar un avertisment?
Până la Node 14 respingerile netratate dădeau UnhandledPromiseRejectionWarning și programul continua. Din Node 15 implicit programul se oprește, ca să nu rămână ascunse erorile.
Am pus try/catch și tot apare. De ce?
Probabil apelul nu e așteptat: try { salveaza() } catch {} fără await nu prinde nimic, pentru că promisiunea e respinsă mai târziu, după ce blocul try s-a terminat. Scrie await salveaza().
Erori înrudite
TypeError [ERR_INVALID_ARG_TYPE]: The "cb" argument must be of type function. Received undefined Ai apelat o funcție asincronă din fs (readFile, writeFile, readdir...) fără callback, ca și cum ar întoarce direct rezultatul. Ori dai un callback (err, date) => {...}, ori folosești varianta Sync, ori fs/promises cu await. Error [ERR_UNHANDLED_ERROR]: Unhandled error. ('Senzor deconectat') Un EventEmitter a emis evenimentul 'error' și nu are niciun ascultător pentru el, așa că Node oprește programul. Adaugă emitter.on("error", (err) => {...}) înainte de emit și emite obiecte Error, nu texte. 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. Î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.
