TypeScript este un superset tipat static de JavaScript dezvoltat și întreținut de Microsoft, conceput pentru a adăuga siguranță tipurilor, suport avansat pentru unelte de dezvoltare (autocompletare inteligentă, refactorizare automată) și o arhitectură robustă aplicațiilor web și Node.js de scară largă. Codul TypeScript este compilat în JavaScript standard pur, funcționând identic în orice browser sau runtime modern.
Această secțiune oferă o documentație completă și modernă în limba română pentru TypeScript 5.x: de la concepte fundamentale (tipuri primitive, interfețe, uniuni, generics) și noutăți recente (operatorul satisfies, parametri de tip const, decoratori Stage 3, managementul resurselor cu using), până la matricea tipurilor utilitare și ghidul exhaustiv al opțiunilor din tsconfig.json.
// Pipeline-ul de compilare din tsc (TypeScript Compiler):
// 1. Scanner (Lexer): Convertește codul sursă text într-un flux de token-uri.
// 2. Parser: Transformă token-urile într-un arbore de sintaxă abstractă (AST).
// 3. Binder: Creează "Symbols" și leagă identificatorii de scope-urile corespunzătoare.
// 4. Checker: Motorul semantic central (90% din logica tsc) - validează regulile de tipare!
// 5. Emitter: Generează fișierele JavaScript (.js) și declarațiile de tip (.d.ts).
// REGULA DE AUR: Type Erasure (Ștergerea Tipurilor la Runtime)
// Tipurile din TypeScript există EXCLUSIV în timpul compilării și în editor!
// Compilatorul elimină complet toate interfețele, tipurile alias și adnotările:
type User = { id: number; name: string };
function salut(u: User): string { return `Salut, ${u.name}!`; }
// Codul emis în JavaScript este pur:
// function salut(u) { return `Salut, ${u.name}!`; }
// -> Concluzie: Tipurile nu consumă memorie la runtime, dar datele externe (API/formulare)
// trebuie validate la rulare folosind librării precum Zod sau Valibot!
Sistemul de Tipare Structurală (Duck Typing)
Spre deosebire de limbaje cu tipare nominală strictă (cum ar fi Java sau C# unde două clase sunt compatibile doar dacă una o moștenește pe cealaltă sau implementează explicit aceeași interfață), TypeScript folosește Structural Typing (deseori numit Duck Typing: „dacă merge ca o rață și măcăne ca o rață, este o rață”):
interface Punct2D {
x: number;
y: number;
}
function afiseazaCoordonate(p: Punct2D) {
console.log(`Punct la coordonatele (${p.x}, ${p.y})`);
}
// Obiectul nu declară explicit că implementează 'Punct2D', dar are proprietățile necesare:
const cursorMouse = { x: 150, y: 300, click: true };
// VALID în TypeScript! Deoarece cursorMouse conține proprietățile 'x' și 'y' de tip number:
afiseazaCoordonate(cursorMouse);
Control Flow Analysis (CFA) și Tehnici de Type Narrowing
Compilatorul TypeScript analizează fluxul logic al execuției pas cu pas (Control Flow Analysis) și restrânge automat tipurile variabilelor în funcție de verificările efectuate în cod:
- Operatorul
typeof: Distinge tipuri primitive (typeof x === 'string'). - Operatorul
instanceof: Verifică dacă un obiect este o instanță a unei clase (err instanceof Error). - Operatorul
in: Verifică prezența unei proprietăți specifice într-un obiect ('rol' in utilizator). - Uniuni Discriminate (Discriminated Unions): Asocierea unei proprietăți comune literale (ex:
typesaustatus) care permite compilatorului să restrângă instantaneu tipul într-un blocswitch. - Predicate de Tip Personalizate: Funcții cu semnătură de tip
val is TipSpecificcare transferă logica de validare către TypeScript.
Matricea Tipurilor Utilitare Globale (Utility Types)
TypeScript include o suită completă de tipuri generice globale care transformă și adaptează tipurile existente fără duplicare de cod:
| Tip Utilitar | Transformare Efectuată | Exemplu de Sintaxă |
|---|---|---|
Partial<T> |
Transformă toate proprietățile din T în proprietăți opționale (adaugă ?). |
type UserPatch = Partial<User>; |
Required<T> |
Elimină caracterul opțional; toate proprietățile devin obligatorii. | type UserComplet = Required<UserProps>; |
Readonly<T> |
Îngheață proprietățile; reatribuirea lor generează eroare de compilare. | type ConfigFix = Readonly<AppConfig>; |
Record<K, T> |
Creează un tip dicționar ale cărui chei sunt de tip K și valorile de tip T. |
type Preturi = Record<'EUR' | 'USD' | 'RON', number>; |
Pick<T, K> |
Extrage din T doar setul de chei specificat în uniunea K. |
type UserPreview = Pick<User, 'id' | 'nume'>; |
Omit<T, K> |
Construiește un tip prin eliminarea cheilor K din T. |
type UserFaraParola = Omit<User, 'parola_hash'>; |
Exclude<T, U> |
Exclude din uniunea T toate tipurile care sunt asignabile lui U. |
type NonText = Exclude<string | number | boolean, string>; |
Extract<T, U> |
Păstrează din uniunea T doar tipurile care sunt asignabile lui U. |
type DoarText = Extract<string | number, string>; |
NonNullable<T> |
Elimină null și undefined din tipul T. |
type EmailValid = NonNullable<string | null | undefined>; |
ReturnType<T> |
Extrage tipul returnat de o funcție T. |
type ApiData = ReturnType<typeof fetchUtilizator>; |
Parameters<T> |
Extrage tipurile parametrilor unei funcții sub formă de tuplu. | type Params = Parameters<typeof calculeazaTotal>; |
Awaited<T> |
Desfășoară recursiv un Promise<T>, returnând tipul valorii rezolvate. |
type DateReale = Awaited<Promise<string[]>>; |
Discuții, Întrebări & Coduri TypeScript
Ai o întrebare legată de TypeScript, cauți o soluție sau vrei să împărtășești un fragment util de cod? Trimite mai jos contribuția ta.
Fii primul care pune o întrebare sau distribuie un fragment de cod / prompt!
Nu au fost adăugate încă întrebări sau exemple de cod pentru această pagină. Dacă ai întâlnit o problemă sau ai un snippet util, adaugă-l mai jos pentru a-i ajuta pe ceilalți.