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

Error [ERR_FALSY_VALUE_REJECTION]: Promise was rejected with falsy value

Pe scurt

O funcție async trecută prin util.callbackify a fost respinsă cu o valoare falsy (undefined, null, 0, ""), iar Node o împachetează în această eroare, ca callback-ul să primească totuși un err. Respinge întotdeauna cu un obiect Error: throw new Error("motiv") sau Promise.reject(new Error("motiv")).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

util.callbackify(fn) transformă o funcție care întoarce o promisiune într-o funcție cu callback (err, rezultat). Când promisiunea e respinsă, motivul devine err.

Problema: în stilul callback, if (err) e fals pentru null, undefined, 0 sau "". Dacă promisiunea e respinsă cu o astfel de valoare, callback-ul ar crede că totul a mers bine. Ca să nu se piardă eșecul, Node înlocuiește valoarea cu o eroare nouă, ERR_FALSY_VALUE_REJECTION, iar valoarea originală o pune în proprietatea reason.

Mesajul apare de obicei când callback-ul aruncă mai departe err sau îl afișează. Cauza reală e în funcția async: throw; fără nimic, return Promise.reject(), throw undefined sau o respingere cu un rezultat gol.

De ce apare: cauzele frecvente

1Respingere fără motiv

Greșit
JavaScript
async function gasesteClient(id) {
  const c = clienti.find((x) => x.id === id);
  if (!c) return Promise.reject();
  return c;
}
Corect
JavaScript
async function gasesteClient(id) {
  const c = clienti.find((x) => x.id === id);
  if (!c) throw new Error(`Clientul ${id} nu există`);
  return c;
}

Un obiect Error e mereu truthy și are message și stivă, deci callback-ul îl recunoaște ca eroare.

2throw cu o valoare goală

Greșit
JavaScript
async function valideaza(text) {
  if (!text) throw text; // "" sau undefined
}
Corect
JavaScript
async function valideaza(text) {
  if (!text) throw new Error("Textul e gol");
}

throw text aruncă exact valoarea goală, care e falsy.

3Respingere cu un cod numeric 0

Greșit
JavaScript
if (stoc === 0) throw stoc;
Corect
JavaScript
if (stoc === 0) throw Object.assign(new Error("Stoc epuizat"), { cod: 0 });

Dacă ai nevoie de un cod, pune-l ca proprietate pe obiectul Error.

Repară tu

Repară eroarea, direct în pagină

Codul vechi al aplicației folosește callback-uri, așa că funcția gasesteClient e transformată cu util.callbackify. Când clientul nu există, ea face Promise.reject() fără motiv, iar programul se oprește cu Promise was rejected with falsy value. Respinge cu o eroare cu mesaj clar, ca programul să afișeze clientul găsit și mesajul pentru cel lipsă.

Codul care dă eroarea
JavaScript
const util = require("util");

const clienti = [{ id: 1, nume: "Ana" }, { id: 2, nume: "Mihai" }];

async function gasesteClient(id) {
  const client = clienti.find((c) => c.id === id);
  if (!client) return Promise.reject();
  return client;
}

const gasesteClientCb = util.callbackify(gasesteClient);

for (const id of [2, 7]) {
  gasesteClientCb(id, (err, client) => {
    if (err) throw err;
    console.log(`Gasit: ${client.nume}`);
  });
}
După reparație, programul afișează
Gasit: Mihai
Eroare: Clientul 7 nu exista
Indiciu

În funcția async, scrie throw new Error(Clientul ${id} nu exista).

Alte forme ale mesajului

  • Error [ERR_FALSY_VALUE_REJECTION]: Promise was rejected with falsy value at process.processTicksAndRejections (node:internal/process/task_queues:90:21) { code: 'ERR_FALSY_VALUE_REJECTION', reason: undefined }
  • Error [ERR_FALSY_VALUE_REJECTION]: Promise was rejected with falsy value { reason: null }
  • code: 'ERR_FALSY_VALUE_REJECTION', reason: ''

Cum o eviți pe viitor

  • Aruncă și respinge doar obiecte Error (sau clase derivate din Error).
  • Activează regula ESLint prefer-promise-reject-errors și no-throw-literal.
  • Dacă ai nevoie de valoarea originală, citește-o din err.reason.
  • În cod nou, preferă async/await direct în locul lui callbackify; folosește-l doar ca punte cu API-uri vechi.

Întrebări frecvente

Unde găsesc valoarea cu care a fost respinsă promisiunea?

În err.reason. De exemplu, dacă ai respins cu null, err.reason este null.

Apare și fără callbackify?

Nu. Fără callbackify, o promisiune respinsă cu undefined ajunge ca atare în catch. Dacă nu e prinsă, Node raportează o respingere netratată cu motivul undefined.

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.