TypeError [ERR_INVALID_ARG_TYPE]: The "code" argument must be of type number. Received type string ('eroare')
process.exit() și process.exitCode primesc un cod numeric: 0 înseamnă succes, orice altceva (de obicei 1) înseamnă eroare. De la Node 20, un text ca "eroare" nu mai e acceptat. Afișează mesajul cu console.error și ieși cu process.exit(1), sau setează process.exitCode = 1.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Codul de ieșire e un număr pe care procesul îl lasă sistemului de operare când se termină. Scripturile din package.json, CI-ul (GitHub Actions, GitLab), Docker și orice shell îl citesc: 0 înseamnă că totul a mers, orice altă valoare că ceva a eșuat.
În versiunile vechi, Node accepta orice valoare la process.exit(...) și o transforma, de multe ori în tăcere, în 0, deci un script „eșuat” părea reușit. De la Node 20, valoarea e verificată: trebuie să fie un întreg (sau un text care conține doar un întreg, ca "1"). Mesajul îți arată ce ai trimis: Received type string ('eroare').
Greșeala tipică: ai dat mesajul de eroare ca argument (process.exit("Fișier lipsă")), crezând că va fi afișat. Mesajul se afișează separat, cu console.error, iar codul de ieșire e doar numărul.
De ce apare: cauzele frecvente
1Mesajul dat ca argument
process.exit("Fișierul de configurare lipsește");console.error("Fișierul de configurare lipsește");
process.exit(1);Mesajul merge pe stderr, iar codul 1 spune shell-ului și CI-ului că programul a eșuat.
2Stare text transformată direct în cod
const stare = erori.length ? "eroare" : "ok";
process.exit(stare);process.exit(erori.length ? 1 : 0);Codul de ieșire are doar două sensuri practice: 0 pentru succes și un număr diferit de 0 pentru eșec.
3process.exit oprește prea brusc
await scrieRaport();
process.exit(erori.length);await scrieRaport();
process.exitCode = erori.length ? 1 : 0;process.exitCode lasă programul să termine ce are de scris (loguri, fișiere) și setează doar codul. Ține minte și că un cod mai mare de 255 e trunchiat de sistem.
Repară eroarea, direct în pagină
Scriptul verifică un fișier de import și trebuie să iasă cu codul 0 dacă nu găsește erori, sau 1 dacă găsește. În loc de număr, îi dă lui process.exit un text, iar programul dă TypeError [ERR_INVALID_ARG_TYPE]: The "code" argument must be of type number. Dă-i codul numeric potrivit, ca scriptul să afișeze rezultatul verificării și să se încheie cu succes.
const randuri = [
{ produs: "Cafea", pret: 42 },
{ produs: "Ceai", pret: 18 },
];
const erori = randuri.filter((r) => !r.produs || !(r.pret > 0));
console.log(`Rânduri verificate: ${randuri.length}`);
console.log(`Erori: ${erori.length}`);
const stare = erori.length === 0 ? "ok" : "eroare";
process.exit(stare);Rânduri verificate: 2 Erori: 0
Indiciu
Fără erori, codul de ieșire este 0; cu erori, 1.
Reparația
const randuri = [
{ produs: "Cafea", pret: 42 },
{ produs: "Ceai", pret: 18 },
];
const erori = randuri.filter((r) => !r.produs || !(r.pret > 0));
console.log(`Rânduri verificate: ${randuri.length}`);
console.log(`Erori: ${erori.length}`);
process.exit(erori.length === 0 ? 0 : 1);De ce merge
process.exit primește codul de ieșire al procesului, un număr pe care îl citesc shell-ul, scripturile npm și CI-ul. Textele "ok" și "eroare" nu sunt coduri valide, iar Node 20+ le refuză. Cu 0 pentru succes și 1 pentru erori, scriptul comunică rezultatul corect și poate fi folosit într-un pipeline: un pas cu erori în date ar opri automat restul.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "code" argument must be of type number. Received type boolean (true)TypeError [ERR_INVALID_ARG_TYPE]: The "code" argument must be of type number. Received an instance of ErrorRangeError [ERR_OUT_OF_RANGE]: The value of "code" is out of range. It must be an integer. Received 1.5
Cum o eviți pe viitor
- Folosește doar 0 (succes) și 1 (eșec), sau coduri documentate dacă scriptul e folosit de alte unelte.
- Afișează motivul cu
console.error, separat de cod. - Preferă
process.exitCode = 1în locul luiprocess.exit(1)când mai există scrieri sau cereri în curs.
Întrebări frecvente
Unde văd codul de ieșire?
În terminal, imediat după rulare: echo $? pe Linux și macOS, echo $LASTEXITCODE în PowerShell. În CI, un cod diferit de 0 marchează pasul ca eșuat.
De ce mergea în Node 18?
Versiunile vechi nu verificau valoarea. Un text era convertit și, de multe ori, procesul ieșea cu codul 0, adică „succes”, deși tu voiai să semnalezi o eroare. Verificarea din Node 20 previne exact acest bug.
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. Error [ERR_USE_AFTER_CLOSE]: readline was closed Ai apelat rl.question() (sau alt apel readline) după ce interfața s-a închis: fie ai apelat rl.close() prea devreme, fie intrarea s-a terminat (Ctrl+D sau date trimise prin pipe), iar readline s-a închis singur. Pune rl.close() după ultima întrebare și nu mai întreba nimic în handler-ul close. TypeError: process.stdout.clearLine is not a function process.stdout.clearLine, cursorTo și setRawMode există doar când ieșirea (sau intrarea) e un terminal. Când rulezi prin pipe, în CI, în Docker fără -t sau în unele editoare, stdout e un flux simplu și metodele lipsesc. Verifică process.stdout.isTTY și afișează altfel când e false. Î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.
