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

Variabile de mediu: process.env

Același program rulează pe laptopul tău, pe serverul de test și în producție, dar cu setări diferite: alt port, altă bază de date, alt mod. Setările acestea nu se scriu în cod, ci vin din variabilele de mediu, pe care Node ți le dă în process.env.

Ce sunt variabilele de mediu

Sistemul de operare ține pentru fiecare program o listă de perechi NUME=valoare, numite variabile de mediu (environment variables). Programul le primește la pornire, la fel ca argumentele, dar ele descriu mediul în care rulează, nu sarcina de făcut.

PORT=4000 NODE_ENV=production node server.js

Comanda de mai sus (în Linux/macOS) pornește serverul cu două variabile de mediu. Pe serverele reale ele sunt setate o singură dată, în configurația platformei de găzduire.

Bine de știut

Prin convenție, numele variabilelor de mediu se scriu cu MAJUSCULE și underscore: PORT, NODE_ENV, DATABASE_URL, API_KEY.

Exercițiul tău

Programul rulează cu variabilele de mediu NUME_APP=Magazin și PORT=4000 (NODE_ENV nu este setată). Citește-le din process.env și afișează: Aplicație: Magazin Port: 4000 Mod: development Pentru mod folosește valoarea implicită "development" cu ??.

  • Citește NUME_APP și PORT din process.env.
  • Citește NODE_ENV cu valoarea implicită "development".
  • Afișează cele trei linii.
process.env.NODE_ENV ?? "development" dă "development" când variabila lipsește.

Soluția exercițiului

const numeApp = process.env.NUME_APP;
const port = process.env.PORT;
const mod = process.env.NODE_ENV ?? "development";

console.log(`Aplicație: ${numeApp}`);
console.log(`Port: ${port}`);
console.log(`Mod: ${mod}`);
Excelent! Continuă cu lecția următoare →
Vrei să afli mai mult?Citirea cu process.env · Valori implicite: ?? și || · NODE_ENV: development vs production · Exemple reale

Citirea cu process.env

process.env este un obiect: fiecare variabilă de mediu e o proprietate. Exemplele din lecție rulează cu NUME_APP=Magazin și PORT=4000:

console.log(process.env.NUME_APP);
console.log(process.env.PORT);
console.log(typeof process.env.PORT);
console.log(process.env.NODE_ENV);
Magazin
4000
string
undefined

Ca și argumentele, valorile sunt texte ("4000", nu 4000). O variabilă care nu există dă undefined.

Atenție

Nu afișa niciodată tot process.env: conține setări ale calculatorului și, pe servere, parole și chei secrete. Citește doar variabilele de care ai nevoie.

Valori implicite: ?? și ||

Aproape orice variabilă de mediu are o valoare implicită, ca programul să meargă și când nu e setată:

const port = Number(process.env.PORT ?? 3000);
const mod = process.env.NODE_ENV ?? "development";
const limba = process.env.LIMBA || "ro";

console.log(`Port: ${port}, mod: ${mod}, limba: ${limba}`);
Port: 4000, mod: development, limba: ro
OperatorFolosește valoarea implicită când variabila ePentru LIMBA=""
??undefined sau nullrămâne ""
||orice valoare „falsă” ("", undefined...)devine "ro"

Dacă vrei ca o variabilă setată goală să fie tratată ca lipsă, folosește ||. Altfel, ?? e alegerea mai sigură.

NODE_ENV: development vs production

NODE_ENV este cea mai cunoscută variabilă din lumea Node. Multe biblioteci (inclusiv Express) se comportă diferit în funcție de ea: în development afișează erori detaliate, în production ascund detaliile și sunt mai rapide.

const mod = process.env.NODE_ENV ?? "development";
const esteProductie = mod === "production";

console.log("Mod:", mod);
console.log("Afișez erori detaliate:", !esteProductie);
Mod: development
Afișez erori detaliate: true

Exemple reale

Portul serverului

Platformele de găzduire (Render, Railway, Heroku) îți dau portul în process.env.PORT; dacă îl ignori, aplicația nu pornește acolo.

Chei secrete

Cheia pentru plăți sau parola bazei de date stau în variabile de mediu, niciodată în cod sau în Git.

Teste

NODE_ENV=test face aplicația să folosească o bază de date separată pentru teste.

  • process.env.NUME citește o variabilă de mediu (text sau undefined).
  • Dai valori implicite cu ?? sau ||.
  • Setările care diferă între calculatoare stau în variabile de mediu, nu în cod.
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 11 · Variabile de mediu: process.env
Progres 0% 0 din 17
Lecția curentă 11 / 15 Proces