...
Eroare Node.js · Asincron: callback-uri, promisiuni și timere

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".

Pe scurt

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

Greșit
JavaScript
async function main() {
  const comanda = await plaseazaComanda(7);
  console.log(comanda);
}
main();
Corect
JavaScript
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()

Greșit
JavaScript
trimiteEmail(client).then(() => console.log("Trimis"));
Corect
JavaScript
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

Greșit
JavaScript
if (stoc < cantitate) throw "Stoc insuficient";
Corect
JavaScript
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

Greșit
JavaScript
for (const id of ids) {
  salveaza(id);
}
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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();
După reparație, programul afișează
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.

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 jurul await-urilor care pot eșua, sau măcar în funcția main.
  • 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

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.