...
← Curs Node.js: toate lecțiile
Lecția 13 · Proiect

Mini-proiect: un CLI de salut

E timpul să pui împreună tot ce ai învățat: argumente, opțiuni de tipul --majuscule, variabile de mediu și formatare. Construiești un mic program de terminal (CLI) care salută utilizatorul în limba aleasă, așa cum funcționează uneltele adevărate.

Ce construim

Programul se folosește așa:

node index.js Maria
# Salut, Maria!

node index.js Maria --majuscule
# SALUT, MARIA!

LIMBA=en node index.js Maria --majuscule
# HELLO, MARIA!
  • argumentul (Maria) spune pe cine salutăm;
  • opțiunea --majuscule schimbă felul în care se afișează;
  • variabila de mediu LIMBA alege limba (ro implicit sau en).
Bine de știut

Exemplele din această lecție rulează ca LIMBA=en node index.js Maria --majuscule, exact ca exercițiul.

Exercițiul tău

Programul rulează ca LIMBA=en node index.js Maria --majuscule (argumentele ["Maria", "--majuscule"], variabila de mediu LIMBA=en). Construiește salutul: Salut pentru ro (implicit) sau Hello pentru en, urmat de , <nume>!. Dacă există opțiunea --majuscule, transformă tot textul în majuscule. Afișează: HELLO, MARIA! Limba: en

  • Separă opțiunile (care încep cu --) de valori.
  • Citește limba din process.env.LIMBA (implicit ro).
  • Construiește salutul și aplică toUpperCase() dacă ai --majuscule.
  • Afișează salutul și Limba: ....
argumente.includes("--majuscule") îți spune dacă opțiunea a fost dată.

Soluția exercițiului

const saluturi = { ro: "Salut", en: "Hello" };
const argumente = process.argv.slice(2);

const nume = argumente.find((a) => !a.startsWith("--"));
const majuscule = argumente.includes("--majuscule");
const limba = process.env.LIMBA ?? "ro";

let salut = `${saluturi[limba] ?? saluturi.ro}, ${nume}!`;
if (majuscule) {
  salut = salut.toUpperCase();
}

console.log(salut);
console.log(`Limba: ${limba}`);
Excelent! Continuă cu lecția următoare →
Vrei să afli mai mult?Pasul 1: argumente și opțiuni · Pasul 2: limba din mediu · Pasul 3: totul împreună · Unelte reale construite la fel

Pasul 1: argumente și opțiuni

Convenția din lumea CLI: ce începe cu -- este o opțiune (flag), restul sunt argumente obișnuite. Le separi cu filter:

const argumente = process.argv.slice(2);
const optiuni = argumente.filter((a) => a.startsWith("--"));
const valori = argumente.filter((a) => !a.startsWith("--"));

console.log("Opțiuni:", optiuni);
console.log("Valori:", valori);
console.log("Majuscule?", optiuni.includes("--majuscule"));
Opțiuni: [ '--majuscule' ]
Valori: [ 'Maria' ]
Majuscule? true

Așa nu contează ordinea: node index.js --majuscule Maria funcționează la fel.

Pasul 2: limba din mediu

Ținem textele într-un obiect, cu câte o cheie pentru fiecare limbă. Variabila de mediu alege cheia:

const saluturi = { ro: "Salut", en: "Hello" };
const limba = process.env.LIMBA ?? "ro";
const cuvant = saluturi[limba] ?? saluturi.ro;

console.log(`Limba: ${limba}`);
console.log(`Cuvânt: ${cuvant}`);
Limba: en
Cuvânt: Hello

saluturi[limba] ?? saluturi.ro protejează programul de o limbă necunoscută (de exemplu LIMBA=fr): se întoarce la română.

Pasul 3: totul împreună

const saluturi = { ro: "Salut", en: "Hello" };

function construiesteSalut(nume, limba, majuscule) {
  const text = `${saluturi[limba] ?? saluturi.ro}, ${nume}!`;
  return majuscule ? text.toUpperCase() : text;
}

console.log(construiesteSalut("Ion", "ro", false));
console.log(construiesteSalut("Ion", "en", false));
console.log(construiesteSalut("Ion", "en", true));
Salut, Ion!
Hello, Ion!
HELLO, ION!
1
Funcția primește tot ce îi trebuie ca parametri: e ușor de testat, fără să depindă de process.
2
Programul principal citește process.argv și process.env și le dă funcției.
3
Separarea „citesc datele” / „calculez rezultatul” e un obicei bun pe care îl vei folosi în tot cursul.

Unelte reale construite la fel

git, npm, docker

Toate au argumente (npm install express), opțiuni (--save-dev) și citesc setări din mediu.

Limba programelor

Multe programe din Linux își aleg limba mesajelor din variabila de mediu LANG.

Scripturi de echipă

Un deploy.js primește mediul ca argument (staging) și cheile din variabile de mediu.

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 13 · Mini-proiect: un CLI de salut
Progres 0% 0 din 17
Lecția curentă 13 / 15 Proiect