Error [ERR_FALSY_VALUE_REJECTION]: Promise was rejected with falsy value
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
async function gasesteClient(id) {
const c = clienti.find((x) => x.id === id);
if (!c) return Promise.reject();
return c;
}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ă
async function valideaza(text) {
if (!text) throw text; // "" sau undefined
}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
if (stoc === 0) throw stoc;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ă 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ă.
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}`);
});
}Gasit: Mihai Eroare: Clientul 7 nu exista
Indiciu
În funcția async, scrie throw new Error(Clientul ${id} nu exista).
Reparația
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) throw new Error(`Clientul ${id} nu exista`);
return client;
}
const gasesteClientCb = util.callbackify(gasesteClient);
for (const id of [2, 7]) {
gasesteClientCb(id, (err, client) => {
if (err) {
console.log(`Eroare: ${err.message}`);
return;
}
console.log(`Gasit: ${client.nume}`);
});
}De ce merge
Promise.reject() respinge cu undefined. Ca stilul callback (if (err)) să nu creadă că totul a mers bine, callbackify înlocuiește valoarea cu ERR_FALSY_VALUE_REJECTION. Cu throw new Error(...), callback-ul primește un obiect Error cu mesaj util. Callback-ul îl afișează și se oprește cu return, în loc să-l arunce mai departe.
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 dinError). - Activează regula ESLint
prefer-promise-reject-errorsșino-throw-literal. - Dacă ai nevoie de valoarea originală, citește-o din
err.reason. - În cod nou, preferă
async/awaitdirect în locul luicallbackify; 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
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. TypeError [ERR_INVALID_ARG_TYPE]: The "original" argument must be of type function. Received undefined util.promisify() a primit undefined (sau altceva) în loc de o funcție cu callback: numele funcției e scris greșit (fs.readfile în loc de fs.readFile) sau funcția nu există în modul. Verifică numele; pentru fs folosește direct fs.promises sau node:fs/promises. TypeError: callback is not a function Funcția ta așteaptă un callback ca ultim argument, dar a fost apelată fără el (sau cu argumentele în altă ordine), așa că la final callback e undefined. Dă-i funcția care primește rezultatul: citeste(fisier, (err, date) => { ... }), sau rescrie funcția să întoarcă o promisiune. Î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.
