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ă |
|---|---|
| 0 | succes |
| 1 | eroare 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
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.
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;
} 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ă argumentFără argument, programul scrie mesajul pe stderr și se oprește cu codul 1. În terminal, echo $? ar afișa 1.
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.
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
Dacă testele întorc alt cod decât 0, GitHub Actions oprește deploy-ul și marchează commit-ul cu roșu.
npm run test && npm run build: build-ul pornește doar dacă testele au trecut (cod 0).
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ă.
