...
Eroare Node.js · Proces, terminal și intrare de la tastatură

TypeError [ERR_INVALID_ARG_TYPE]: The "code" argument must be of type number. Received type string ('eroare')

Pe scurt

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

Greșit
JavaScript
process.exit("Fișierul de configurare lipsește");
Corect
JavaScript
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

Greșit
JavaScript
const stare = erori.length ? "eroare" : "ok";
process.exit(stare);
Corect
JavaScript
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

Greșit
JavaScript
await scrieRaport();
process.exit(erori.length);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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);
După reparație, programul afișează
Rânduri verificate: 2
Erori: 0
Indiciu

Fără erori, codul de ieșire este 0; cu erori, 1.

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 Error
  • RangeError [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 lui process.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

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