...
← Curs Node.js: toate lecțiile
Lecția 12 · Proces

Codul de ieșire: process.exit și process.exitCode

Când un program se termină, el lasă în urmă un număr: codul de ieșire. 0 înseamnă „totul a mers bine”, orice altceva înseamnă „a apărut o problemă”. Scripturile, serverele de testare și uneltele de deploy se uită la acest număr ca să decidă ce fac mai departe.

Ce este codul de ieșire

Fiecare program din terminal întoarce sistemului de operare un număr întreg când se oprește. Prin convenție:

CodÎnseamnă
0succes
1eroare generală (cel mai folosit)
2, 3, ...alte erori, cu sens ales de program (ex. argumente greșite)

Dacă programul se termină normal, Node întoarce 0. Dacă se oprește din cauza unei erori neprinse, întoarce 1. Tu poți alege codul cu process.exitCode sau process.exit(cod).

node index.js && echo "A mers"
# echo rulează doar dacă node a întors codul 0
Exercițiul tău

Programul rulează ca node index.js 5. Scrie funcția valideaza(arg) care întoarce "Argument valid: <număr>" dacă argumentul este un număr, altfel "Argument invalid". În programul principal: dacă mesajul începe cu Argument valid, afișează-l și setează process.exitCode = 0; altfel afișează mesajul și setează process.exitCode = 1 (ramura aceasta nu se execută cu argumentul 5). Rezultatul: Argument valid: 5

  • Scrie valideaza(arg) folosind Number și Number.isNaN.
  • Apelează funcția cu process.argv[2].
  • Afișează mesajul și setează process.exitCode după rezultat.
mesaj.startsWith("Argument valid") îți spune ce ramură să alegi.

Soluția exercițiului

function valideaza(arg) {
  const numar = Number(arg);
  if (arg === undefined || Number.isNaN(numar)) {
    return "Argument invalid";
  }
  return `Argument valid: ${numar}`;
}

const mesaj = valideaza(process.argv[2]);
if (mesaj.startsWith("Argument valid")) {
  console.log(mesaj);
  process.exitCode = 0;
} else {
  console.log(mesaj);
  process.exitCode = 1;
}
Excelent! Continuă cu lecția următoare →
Vrei să afli mai mult?process.exitCode: codul, fără oprire bruscă · process.exit(cod): oprire imediată · Unde contează codul de ieșire

process.exitCode: codul, fără oprire bruscă

process.exitCode = cod stabilește codul cu care se va termina programul, dar îl lasă să-și termine treaba. Este varianta recomandată.

const erori = [];

if (erori.length === 0) {
  console.log("Fișierul este valid");
  process.exitCode = 0;
} else {
  console.log(`Am găsit ${erori.length} erori`);
  process.exitCode = 1;
}
console.log("Raport terminat");
Fișierul este valid
Raport terminat

Observă că Raport terminat se afișează: setarea lui exitCode nu oprește programul.

process.exit(cod): oprire imediată

process.exit(cod) oprește programul chiar în acel moment. Ce urmează după el nu mai rulează:

const fisier = process.argv[2];

if (!fisier) {
  console.error("Utilizare: node index.js <fisier>");
  process.exit(1);
}

console.log("Procesez", fisier); // nu se ajunge aici fără argument

Fără argument, programul scrie mesajul pe stderr și se oprește cu codul 1. În terminal, echo $? ar afișa 1.

Atenție

process.exit() poate tăia mesaje care încă se scriu sau operații neterminate (o scriere în fișier, o cerere). Preferă process.exitCode și lasă programul să se termine singur.

Bine de știut

La exercițiile din acest curs, un cod de ieșire diferit de 0 înseamnă exercițiu picat, la fel cum un server de testare ar marca build-ul ca eșuat. Ramurile cu exit(1) pot exista în cod, dar nu trebuie să se execute cu datele date.

Unde contează codul de ieșire

CI / testare automată

Dacă testele întorc alt cod decât 0, GitHub Actions oprește deploy-ul și marchează commit-ul cu roșu.

Scripturi înlănțuite

npm run test && npm run build: build-ul pornește doar dacă testele au trecut (cod 0).

Containere

Docker și Kubernetes repornesc un serviciu care s-a oprit cu un cod de eroare.

  • 0 = succes, orice altceva = eroare.
  • process.exitCode = 1 setează codul și lasă programul să termine.
  • process.exit(1) oprește imediat; folosește-l cu grijă.
index.jsNode.js
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Node.js de la zero Lecția 12 · Codul de ieșire al programului
Progres 0% 0 din 17
Lecția curentă 12 / 15 Proces