Nou Generator de prompt AI — scrie prompturi mai bune pentru ChatGPT, Claude și Gemini →
TS

Învață TypeScript: comenzi explicate cu exemple

210 comenzi 26 de categorii Comunitate & Q&A

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.

Arhitectura Compilatorului TypeScript (tsc) și Conceptul de Type Erasure
// 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ță”):

Exemplu de Compatibilitate Structurală
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: type sau status) care permite compilatorului să restrângă instantaneu tipul într-un bloc switch.
  • Predicate de Tip Personalizate: Funcții cu semnătură de tip val is TipSpecific care 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[]>>;

Generics și tipuri avansate 14 comenzi

Cod asincron și iterare 6 comenzi

Tipuri pentru decoratori (experimentalDecorators) 3 comenzi

Tipuri utilitare pentru obiecte 7 comenzi

Tipuri de bază 13 comenzi

Narrowing și type guards 10 comenzi

Module și declarații 7 comenzi

tsconfig: proiecte și compilare incrementală 4 comenzi

Verificare, medii și unelte 6 comenzi

Interfețe, alias-uri, union și enum 8 comenzi

Funcții 6 comenzi

Clase 12 comenzi

Aserțiuni și operatori pentru null 6 comenzi

Tipuri utilitare pentru union 4 comenzi

Tipuri utilitare pentru funcții și clase 6 comenzi

Tipuri utilitare pentru text 2 comenzi

tsconfig: verificarea tipurilor 19 comenzi

tsconfig: module și rezolvarea importurilor 18 comenzi

tsconfig: interoperabilitate între module 7 comenzi

tsconfig: limbaj și mediu 8 comenzi

tsconfig: fișierele generate (emit) 17 comenzi

tsconfig: fișiere JavaScript 2 comenzi

tsconfig: linia de comandă tsc 10 comenzi

tsconfig: diagnosticare 6 comenzi

tsconfig: editor și fișiere .d.ts 3 comenzi

tsconfig: opțiuni scoase (compatibilitate) 6 comenzi

Index complet de tipuri, utilitare și opțiuni tsconfig în TypeScript

Consultați ghidul complet al sistemului de tipuri TypeScript: de la tipuri primitive, interfețe și clase, până la generics condiționale, tipuri utilitare native și întreaga matrice de configurare a compilatorului tsconfig.json:

Tipuri de bază (13)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
any Tipul care oprește verificarea: o valoare any acceptă orice și poate fi folosită oricum, fără erori de compilare.
array (T[] și Array<T>) Tipul tablourilor: T[] și Array înseamnă același lucru, un tablou cu elemente de tipul T.
bigint și symbol bigint ține numere întregi oricât de mari; symbol este o valoare unică, folosită de obicei drept cheie de proprietate.
Tipuri Nominale și Branded Types în TypeScript (Flavoring) Ghid complet pentru Branded Types (Tipuri Nominale) în TypeScript: prevenirea erorilor critice de business prin diferențierea tipurilor primitive identice structural (UserId vs OrderId).
inferența tipurilor TypeScript deduce singur tipul variabilelor și al rezultatelor din valorile pe care le scrii, fără adnotări.
let și const cu tipuri Declari variabile cu let (se pot schimba) sau const (nu se pot reatribui) și le pui tipul după două puncte.
never Tipul fără nicio valoare: pentru funcții care nu se termină normal și pentru cazurile imposibile din cod.
null și undefined Cu strictNullChecks, null și undefined sunt tipuri separate: o variabilă le acceptă doar dacă tipul ei le include.
string, number, boolean Cele trei tipuri primitive folosite cel mai des: texte, numere (întregi și zecimale) și valori adevărat/fals.
tipuri literale Un tip care acceptă o singură valoare exactă, de exemplu „Iași” sau 3; combinate în union dau liste de valori permise.
tuple Un tablou cu număr fix de elemente, în care fiecare poziție are tipul ei, de exemplu [nume, notă].
unknown Tipul sigur pentru valori necunoscute: acceptă orice, dar nu poți folosi valoarea până nu verifici ce tip are.
void Tipul returnat de funcțiile care nu întorc nicio valoare utilă, de exemplu cele care doar afișează ceva.

Interfețe, alias-uri, union și enum (8)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
const enum Un enum ale cărui valori sunt înlocuite direct în cod la compilare, fără obiect generat la rulare.
enum Un set de constante cu nume, numerice sau text, care există și la rulare ca obiect.
index signatures Descrie obiecte cu chei necunoscute dinainte: [cheie: string]: Tip, sau Record.
interface Descrie forma unui obiect: ce proprietăți are, de ce tip sunt și ce metode are.
interface vs type Când alegi interface și când type: pentru obiecte sunt aproape echivalente, dar au câteva diferențe importante.
intersection (&#038;) Combină mai multe tipuri într-unul: A & B are toate proprietățile lui A și toate proprietățile lui B.
type (alias de tip) Dă un nume oricărui tip: obiect, union, tuple, funcție sau un tip calculat din alte tipuri.
union (|) Un tip care acceptă valori din mai multe tipuri: A | B înseamnă fie A, fie B.

Funcții (6)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
arrow functions cu tipuri Funcțiile săgeată primesc tipuri ca orice funcție; în callback-uri, tipul parametrilor se deduce din context.
funcții cu tipuri Pui tipuri pe parametrii și pe rezultatul funcțiilor; fiecare apel este verificat la compilare.
overload Mai multe semnături pentru aceeași funcție, ca rezultatul să aibă tipul potrivit pentru fiecare fel de apel.
parametri opționali și impliciți Un parametru cu ? poate lipsi la apel (devine undefined); unul cu = valoare primește valoarea implicită.
rest parameters Strâng oricâte argumente într-un tablou: …valori: number[] acceptă f(1), f(1, 2, 3) sau f().
this în funcții Primul parametru numit this declară pe ce obiect trebuie apelată funcția; tsc verifică apelurile.

Clase (12)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
abstract O clasă abstract nu poate fi instanțiată; metodele abstract trebuie implementate în clasele derivate.
accesori get/set Proprietăți calculate: get rulează cod la citire, set rulează cod la scriere, dar se folosesc ca un câmp.
#câmpuri private Câmpurile care încep cu # sunt private și la rulare: nu pot fi citite deloc din afara clasei.
class Clasele din JavaScript, cu tipuri pe câmpuri, constructor și metode, plus modificatori de acces și interfețe.
decoratori Funcții puse cu @ deasupra claselor, metodelor sau câmpurilor, care le modifică sau le înlocuiesc comportamentul.
extends O clasă moștenește câmpurile și metodele altei clase; o interfață preia proprietățile altor interfețe.
implements O clasă promite că respectă una sau mai multe interfețe; tsc verifică dacă are toți membrii ceruți.
public, private, protected Modificatorii de acces spun cine poate folosi un câmp sau o metodă: oricine, doar clasa sau și clasele derivate.
override Marchează o metodă care rescrie o metodă din clasa de bază; tsc dă eroare dacă metoda de bază nu există.
constructor parameter properties Un modificator pus pe un parametru al constructorului declară câmpul și îl inițializează automat.
readonly Marchează o proprietate care primește valoare o singură dată și nu mai poate fi modificată după aceea.
static Membrii static aparțin clasei, nu fiecărui obiect: se folosesc cu NumeClasa.membru.

Generics și tipuri avansate (14)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
conditional types Un tip care alege între două variante după o condiție: T extends U ? X : Y.
Tipuri Condiționale și Cuvântul Cheie infer în TypeScript Ghid complet pentru Conditional Types și operatorul infer în TypeScript: scrierea de logică decizională la nivel de tipuri și extragerea dinamică a tipurilor din Promise, Array sau funcții.
Parametri de Tip const în TypeScript 5.0+ (<const T>) Ghid complet pentru parametrii de tip const introduși în TypeScript 5.0: inferență automată ca readonly și tupluri literale fără a forța apelantul să folosească ‘as const’.
constrângeri generice (extends) T extends Tip limitează tipurile permise pentru T, ca funcția să poată folosi proprietățile lui Tip.
generics (<T>) Parametri de tip: o funcție sau clasă scrisă o dată, care funcționează cu orice tip și păstrează tipul exact.
indexed access (T[K]) T[„cheie”] dă tipul unei proprietăți din T; T[number] dă tipul elementelor unui tablou.
infer În ramura extends a unui tip condițional, infer X „prinde” o parte din tip și o dă un nume.
keyof keyof T dă union-ul numelor de proprietăți ale lui T, de exemplu „nume” | „oras”.
mapped types Construiesc un tip nou trecând prin fiecare cheie a altui tip: { [K in keyof T]: … }.
Operatorul satisfies în TypeScript 4.9+ (Validare fără Pierderea Inferenței) Ghid complet pentru operatorul satisfies introdus în TypeScript 4.9: validarea conformității cu un tip fără lărgirea tipului (type widening) și păstrarea tipurilor literale specifice.
template literal types Tipuri de text construite ca un template string: `id-${number}` acceptă „id-1”, „id-42” și așa mai departe.
typeof (tip) În poziție de tip, typeof x dă tipul variabilei sau funcției x, ca să nu-l scrii de mână.
Ghid de Generics Avansate și Tipuri Condiționale în TypeScript Ghid complet pentru dezvoltarea de tipuri generice avansate: crearea de tipuri utilitare recursive (DeepReadonly, PathKeys), eliminarea recursivității pe coadă și bune practici în arhitectura de biblioteci.
Design Patterns și Arhitectură Type-Safe în TypeScript Enterprise Ghid complet pentru modele de design arhitectural în TypeScript: Builder Pattern cu Phantom Types, Factory cu Discriminated Unions și Result Pattern pentru gestionarea sigură a erorilor fără throw.

Narrowing și type guards (10)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
asserts O funcție asserts aruncă o eroare dacă verificarea eșuează; după apel, TypeScript știe că tipul este cel cerut.
discriminated unions Un union de obiecte cu o proprietate comună de tip literal; verificarea ei arată exact ce variantă ai.
in guard „cheie” in x verifică dacă obiectul are proprietatea și restrânge union-ul la variantele care o au.
instanceof guard x instanceof Clasa verifică dacă obiectul a fost creat din clasă și restrânge tipul la acea clasă.
narrowing TypeScript urmărește verificările din cod (if, switch, return) și restrânge tipul unei variabile în fiecare ramură.
predicat de tip (is) O funcție cu rezultatul x is Tip spune compilatorului că, dacă returnează true, x are tipul Tip.
type guards Verificări la rulare pe care TypeScript le înțelege și după care știe tipul exact al unei valori.
Uniuni Discriminate și Verificare Exhaustivă cu Tipul never Ghid complet pentru Discriminated Unions (Tagged Unions) și Exhaustiveness Checking cu tipul never în TypeScript: modelarea stărilor de business fără stări invalide și siguranță la compilare.
Predicate de Tip Personalizate și Funcții de Aserțiune (is &#038; asserts) Ghid complet pentru User-Defined Type Guards și Assertion Functions în TypeScript: transferul logicii de validare către tsc folosind clauzele is și asserts.
typeof guard Verificarea typeof x === „string” (sau „number”, „boolean”…) restrânge tipul la primitivul respectiv.

Aserțiuni și operatori pentru null (6)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
as (type assertion) Îi spui compilatorului ce tip are o valoare, când știi mai mult decât el; nu face nicio conversie la rulare.
as const Face un literal complet readonly și păstrează valorile exacte ca tipuri: „Iași” în loc de string.
non-null (!) Semnul ! după o expresie îi spune compilatorului că valoarea nu este null sau undefined, fără verificare.
nullish coalescing (??) a ?? b dă a, iar dacă a este null sau undefined dă b; spre deosebire de ||, păstrează 0, „” și false.
optional chaining (?.) a?.b citește proprietatea doar dacă a nu este null sau undefined; altfel întreaga expresie dă undefined.
satisfies Verifică dacă o valoare se potrivește cu un tip, dar păstrează tipul ei exact, mai precis decât Tip.

Tipuri utilitare pentru obiecte (7)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
Remaparea Cheilor în Mapped Types prin Clauza as (Key Remapping) Ghid complet pentru Key Remapping în Mapped Types (TypeScript 4.1+): redenumirea cheilor cu clauza as, combinarea cu Template Literal Types și filtrarea proprietăților prin never.
Omit Omit creează un tip cu toate proprietățile lui T, mai puțin cele cu numele din K.
Partial Partial face toate proprietățile lui T opționale; util pentru actualizări în care trimiți doar ce se schimbă.
Pick Pick păstrează din T doar proprietățile cu numele din K.
Record Record descrie un obiect ale cărui chei sunt K și ale cărui valori au toate tipul T.
Required Required face toate proprietățile lui T obligatorii, inclusiv pe cele marcate cu ?.
Readonly Readonly face toate proprietățile lui T readonly: obiectul poate fi citit, dar nu modificat.

Tipuri utilitare pentru funcții și clase (6)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
Awaited Awaited dă tipul valorii pe care o obții cu await din T, desfăcând și Promise-urile imbricate.
ConstructorParameters ConstructorParameters dă tipurile parametrilor constructorului clasei, ca tuple.
InstanceType InstanceType dă tipul obiectelor create cu new dintr-un tip de clasă C.
Parameters Parameters dă tipurile parametrilor unei funcții, ca tuple; Parameters[0] este primul parametru.
ReturnType ReturnType dă tipul rezultatului unei funcții; pentru o funcție concretă scrii ReturnType.
ThisParameterType ThisParameterType dă tipul parametrului this al unei funcții; OmitThisParameter îl elimină.

Tipuri utilitare pentru union (4)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
Exclude Exclude elimină din union-ul T variantele care se potrivesc cu U.
Extract Extract păstrează din union-ul T doar variantele care se potrivesc cu U.
NoInfer NoInfer oprește deducerea lui T din acel parametru; T se deduce doar din celelalte argumente.
NonNullable NonNullable elimină null și undefined din tipul T.

Tipuri utilitare pentru text (2)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
Capitalize Capitalize face prima literă a unui tip text mare; Uncapitalize o face mică.
Uppercase Uppercase transformă un tip text în majuscule, Lowercase în litere mici, la nivel de tip.

Tipuri pentru decoratori (experimentalDecorators) (3)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
ClassDecorator Tipul unui decorator de clasă în stilul vechi (experimentalDecorators): primește constructorul clasei.
Decoratori Standard ECMAScript Stage 3 în TypeScript 5.0+ Ghid complet pentru decoratorii standard ECMAScript adoptați în TypeScript 5.0: decoratori de metode, clase, accesorii și câmpuri, fără a mai depinde de experimentalDecorators.
MethodDecorator Tipurile decoratorilor vechi pentru metode, proprietăți și parametri, folosite cu experimentalDecorators.

Module și declarații (7)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
declare Anunță compilatorul că o variabilă, funcție sau modul există deja la rulare, fără să genereze cod pentru ea.
export type Exportă tipuri dintr-un modul; forma export type { … } re-exportă doar tipuri, fără cod la rulare.
fișiere .d.ts Fișiere care conțin doar tipuri: descriu codul JavaScript ca să poată fi folosit din TypeScript cu verificare.
module și import/export Fiecare fișier cu import sau export este un modul; exporți funcții, clase și tipuri și le imporți în alte fișiere.
import type Importă doar tipuri; importul dispare complet din JavaScript-ul generat.
Importuri Inline de Tip și Modulul verbatimModuleSyntax în TypeScript 5.0 Ghid complet pentru Type-Only Imports și flag-ul verbatimModuleSyntax în TypeScript 5.0: diferențierea importurilor de valori de cele de tipuri și eliminarea sigură a dependențelor de compilare.
namespace Grupează cod sub un nume comun; este forma veche de organizare, înlocuită azi de module ES.

Cod asincron și iterare (6)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
async/await cu tipuri O funcție async returnează mereu Promise; await scoate valoarea de tip T din Promise.
generatori cu tipuri Funcțiile function* produc valori una câte una cu yield; tipul lor este Generator.
iteratori cu tipuri Un obiect cu metoda [Symbol.iterator] se poate parcurge cu for…of; tipurile sunt Iterable și Iterator.
Promise<T> Tipul unei valori care va fi disponibilă mai târziu; T este tipul rezultatului, nu și al erorii.
using (resurse) Declară o resursă care se eliberează automat la ieșirea din bloc, chiar dacă apare o eroare.
Gestionarea Explicită a Resurselor cu using și Symbol.dispose în TypeScript 5.2+ Ghid complet pentru declarația using și Symbol.dispose introduse în TypeScript 5.2: eliberarea deterministică și automată a fișierelor, lock-urilor și conexiunilor fără blocuri repetitive try/finally.

Verificare, medii și unelte (6)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
JSDoc cu tipuri Tipuri scrise în comentarii JSDoc, ca TypeScript să verifice fișiere JavaScript fără să le transformi în .ts.
strict mode Opțiunea strict pornește toate verificările stricte: null separat, fără any implicit, câmpuri inițializate și altele.
tipuri pentru DOM Tipurile pentru pagina web (document, elemente, evenimente) vin din biblioteca dom a TypeScript.
tipuri pentru Node.js Tipurile pentru modulele Node.js (fs, path, process…) vin din pachetul @types/node.
@ts-ignore și @ts-expect-error Comentarii care opresc raportarea erorii de pe linia următoare; @ts-expect-error cere ca eroarea să existe.
Siguranță End-to-End la Runtime: Integrarea TypeScript cu Zod și tRPC Ghid complet pentru validarea datelor la granițele sistemului: depășirea limitelor Type Erasure folosind Zod, inferența automată a tipurilor cu z.infer și arhitectura End-to-End Type Safety cu tRPC.

tsconfig: verificarea tipurilor (19)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
allowUnreachableCode Controlează ce face tsc cu codul imposibil de atins și cu etichetele nefolosite: eroare, avertisment în editor sau nimic.
alwaysStrict Verifică fiecare fișier în modul strict al JavaScript și scrie „use strict” în fișierele .js generate.
exactOptionalPropertyTypes O proprietate opțională (telefon?: string) poate lipsi, dar nu poate primi explicit valoarea undefined.
noFallthroughCasesInSwitch Dă eroare când un case care conține cod trece mai departe în următorul case fără break sau return.
noImplicitAny Dă eroare când TypeScript nu poate deduce un tip și ar folosi în tăcere any (de obicei la parametrii fără tip).
noImplicitOverride Obligă scrierea cuvântului override pe metodele din clasele derivate care înlocuiesc o metodă din clasa de bază.
noImplicitReturns Dă eroare când o funcție care întoarce o valoare pe unele ramuri se poate termina fără return pe altele.
noImplicitThis Dă eroare când this este folosit într-o funcție unde tipul lui nu se știe (ar fi any).
noPropertyAccessFromIndexSignature Cheile care vin dintr-o semnătură de index ([cheie: string]) se citesc doar cu paranteze: s[„tema”], nu s.tema.
noUncheckedIndexedAccess Adaugă undefined la tipul valorilor citite cu index (note[0], stoc[„pere”]), pentru că ele pot lipsi.
noUnusedLocals Dă eroare pentru variabilele locale, importurile și funcțiile declarate, dar niciodată citite.
noUnusedParameters Dă eroare pentru parametrii de funcții care nu sunt folosiți; numele care încep cu _ sunt permise.
strict Pornește dintr-o singură mișcare toate verificările stricte de tipuri (strictNullChecks, noImplicitAny și celelalte).
strictBindCallApply Verifică argumentele trimise prin bind, call și apply după tipurile funcției originale.
strictBuiltinIteratorReturn Iteratorii obținuți din Array, Map, Set și String au valoarea finală (done: true) de tip undefined, nu any.
strictFunctionTypes Verifică corect parametrii când atribui o funcție altui tip de funcție (fără bivarianță la parametri).
strictNullChecks Face din null și undefined tipuri separate: o valoare care poate lipsi trebuie verificată înainte de folosire.
strictPropertyInitialization Dă eroare pentru proprietățile de clasă declarate, dar care nu primesc valoare nici la declarare, nici în constructor.
useUnknownInCatchVariables Variabila din catch (e) primește tipul unknown în loc de any, deci trebuie verificată înainte de folosire.

tsconfig: module și rezolvarea importurilor (18)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
allowArbitraryExtensions Permite importul fișierelor cu orice extensie (.css, .svg) dacă există un fișier de declarații de forma nume.d.css.ts.
allowImportingTsExtensions Permite importuri cu extensia .ts („./calcul.ts”), când codul este rulat direct de Node.js, Deno, Bun sau de un bundler.
allowUmdGlobalAccess Permite folosirea unei biblioteci UMD ca variabilă globală dintr-un fișier care este modul (are import/export).
baseUrl Directorul față de care tsc caută importurile fără ./ (de exemplu „utile/calcul”); nu schimbă JavaScript-ul generat.
customConditions Condiții proprii folosite la citirea câmpului exports din package.json, pe lângă import, require, types și node.
module Alege formatul de module din JavaScript-ul generat (ES modules, CommonJS) și regulile de import pe care le verifică tsc.
moduleResolution Alege regulile după care tsc găsește fișierul din spatele unui import („./calcul.js”, „react”, „@/utile”).
moduleSuffixes Lista de sufixe încercate la rezolvarea unui import: „./buton” poate duce la buton.ios.ts (folosit în React Native).
noResolve Nu adaugă în compilare fișierele găsite prin import sau /// ; intră doar fișierele date explicit.
noUncheckedSideEffectImports Verifică și importurile fără nume (import „./polyfill.js”): fișierul trebuie să existe, altfel apare eroare.
paths Definește prescurtări pentru importuri (de exemplu „@/utile/calcul” pentru ./src/utile/calcul) folosite la verificarea tipurilor.
resolveJsonModule Permite importul fișierelor .json, cu tipuri deduse din conținutul lor.
resolvePackageJsonExports Folosește câmpurile exports și imports din package.json la rezolvarea importurilor de pachete și a celor cu #.
rewriteRelativeImportExtensions Rescrie importurile relative care se termină în .ts, .mts, .cts în .js, .mjs, .cjs în fișierele generate.
rootDir Spune care director este rădăcina surselor; structura de sub el se păstrează în outDir.
rootDirs Tratează mai multe directoare ca pe unul singur la rezolvarea importurilor relative (pentru cod generat separat).
typeRoots Alege directoarele din care tsc încarcă automat pachetele de tipuri globale (implicit node_modules/@types).
types Alege exact ce pachete de tipuri globale (din node_modules/@types) se încarcă automat; [] nu încarcă niciunul.

tsconfig: fișierele generate (emit) (17)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
declaration Generează lângă fiecare fișier .js un fișier .d.ts cu tipurile lui, ca alte proiecte să-l poată folosi cu tipuri.
declarationDir Directorul în care se scriu fișierele .d.ts, separat de outDir unde ajunge JavaScript-ul.
declarationMap Generează hărți .d.ts.map, ca „Go to Definition” din editor să ducă la sursa .ts, nu la fișierul .d.ts.
downlevelIteration Pentru target es5: transformă for…of, spread și destructurarea folosind iteratorii reali, nu doar indexul.
emitDeclarationOnly tsc scrie doar fișierele .d.ts, fără .js; JavaScript-ul este produs de altă unealtă (esbuild, Babel, swc).
importHelpers Ia funcțiile ajutătoare (__awaiter, __decorate…) din pachetul tslib, în loc să le copieze în fiecare fișier.
inlineSourceMap Pune harta sursă direct în fișierul .js (base64), nu într-un .js.map separat; inlineSources include și codul .ts.
newLine Alege sfârșitul de rând din fișierele generate (lf sau crlf); emitBOM adaugă marcajul BOM UTF-8 la început.
noEmit tsc doar verifică tipurile și nu scrie niciun fișier (.js, .d.ts, .map).
noEmitOnError Nu scrie niciun fișier dacă există erori de tip; implicit, tsc scrie JavaScript-ul chiar și cu erori.
outDir Directorul în care tsc scrie fișierele generate, cu aceeași structură de subdirectoare ca sursele.
outFile Pune tot JavaScript-ul generat într-un singur fișier; merge doar cu scripturi globale sau cu module amd/system.
preserveConstEnums Păstrează în JavaScript obiectul unui const enum; folosirile lui sunt tot înlocuite cu valorile.
removeComments Scoate comentariile din fișierele .js generate (și din .d.ts).
sourceMap Generează fișiere .js.map care leagă JavaScript-ul generat de rândurile din sursa .ts (pentru depanare și erori).
sourceRoot Schimbă locul unde depanatorul caută sursele .ts (sourceRoot) și hărțile .map (mapRoot), dacă nu sunt lângă fișierele .js.
stripInternal Scoate din fișierele .d.ts declarațiile marcate cu /** @internal */, ca să nu apară în API-ul public.

tsconfig: linia de comandă tsc (10)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
&#8211;help Afișează ajutorul lui tsc: comenzile obișnuite și opțiunile principale; cu –all, toate opțiunile.
&#8211;init Creează un fișier tsconfig.json nou, cu setările recomandate de versiunea curentă de TypeScript.
&#8211;listFilesOnly Afișează fișierele care fac parte din compilare; –listFilesOnly se oprește aici, –listFiles compilează și apoi le afișează.
&#8211;locale Alege limba mesajelor de eroare afișate de tsc (nu schimbă JavaScript-ul generat).
noErrorTruncation Afișează tipurile complete în mesajele de eroare, fără prescurtarea „… 15 more …”.
pretty Afișează erorile cu culori și cu rândul de cod subliniat; implicit pornit când ieșirea este un terminal.
&#8211;project Compilează proiectul descris de un anumit fișier tsconfig (sau de tsconfig.json dintr-un director dat).
&#8211;showConfig Afișează configurația finală (cu extends rezolvat și opțiunile deduse) și lista de fișiere, fără să compileze.
&#8211;version Afișează versiunea compilatorului TypeScript folosit.
&#8211;watch Pornește tsc în modul „watch”: recompilează automat la fiecare salvare a unui fișier.

tsconfig: limbaj și mediu (8)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
experimentalDecorators Activează decoratorii vechi (experimentali) ai lui TypeScript, folosiți de Angular și NestJS, în locul celor standard.
jsx Spune ce face tsc cu sintaxa JSX din fișierele .tsx: o transformă în apeluri de funcții (React) sau o lasă neschimbată.
jsxFactory Pentru jsx: „react”, alege funcția apelată pentru fiecare element (implicit React.createElement) și pentru fragmente.
jsxImportSource Pentru jsx: „react-jsx”, alege pachetul din care se importă automat funcțiile JSX (implicit react).
lib Alege ce declarații de tipuri pentru mediul de rulare sunt incluse: versiunea JavaScript (es2022) și API-urile (dom, webworker).
moduleDetection Decide când un fișier este modul (cu scope propriu) și când este script global; force face din fiecare fișier un modul.
target Versiunea de JavaScript generată: sintaxa mai nouă decât ținta este transformată în cod echivalent mai vechi.
useDefineForClassFields Câmpurile de clasă se comportă ca în standardul JavaScript (definite cu Object.defineProperty), nu ca atribuiri în constructor.

tsconfig: interoperabilitate între module (7)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
erasableSyntaxOnly Interzice construcțiile TypeScript care generează cod (enum, namespace, parametri-proprietate), ca Node.js să poată rula direct fișierele .ts.
esModuleInterop Face importul implicit (import x from „pachet”) al modulelor CommonJS să funcționeze corect, la verificare și la rulare.
forceConsistentCasingInFileNames Dă eroare când același fișier este importat cu litere mari și mici diferite („./Calcul” și calcul.ts).
isolatedDeclarations Cere tipuri scrise explicit pe exporturi, ca fișierele .d.ts să poată fi generate fișier cu fișier, fără verificarea tipurilor.
isolatedModules Dă eroare pentru codul care nu poate fi transformat corect fișier cu fișier (de esbuild, Babel, swc sau Node.js).
preserveSymlinks Nu înlocuiește legăturile simbolice (symlink) cu calea lor reală la rezolvarea importurilor, ca node –preserve-symlinks.
verbatimModuleSyntax Importurile rămân exact cum sunt scrise; se șterg doar cele marcate cu type, deci tipurile trebuie importate cu import type.

tsconfig: diagnosticare (6)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
diagnostics Afișează după compilare statistici: câte fișiere, rânduri și tipuri, memoria folosită și timpul fiecărei etape.
explainFiles Afișează fiecare fișier din compilare și motivul pentru care a fost inclus (include, import, lib, types).
generateTrace Scrie fișiere pentru analiza detaliată a performanței: urmă de evenimente și lista tipurilor, sau un profil CPU V8.
listEmittedFiles Afișează căile fișierelor scrise de tsc la compilare (.js, .d.ts, .map), fiecare cu prefixul TSFILE:.
noCheck Generează fișierele fără verificarea completă a tipurilor; raportează doar erorile de sintaxă și de emitere.
traceResolution Afișează pas cu pas cum găsește tsc fișierul din spatele fiecărui import; util la erori TS2307.

tsconfig: proiecte și compilare incrementală (4)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
composite Pregătește un proiect pentru a fi folosit prin „references” de alte proiecte și construit cu tsc -b.
disableSourceOfProjectReferenceRedirect Trei opțiuni pentru editor în proiectele cu references: cum se încarcă proiectele referite, ca editorul să fie mai rapid.
incremental Salvează informații despre ultima compilare într-un fișier .tsbuildinfo, ca următoarea compilare să refacă doar ce s-a schimbat.
Optimizarea Fișierului tsconfig.json și Arhitecturi Monorepo cu Project References Ghid complet de configurare a compilatorului TypeScript pentru producție: setarea strict: true, compilarea incrementală, integrarea Project References în monorepo-uri și rezolvarea modernă NodeNext.

tsconfig: editor și fișiere .d.ts (3)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
disableSizeLimit Scoate limita de 20 MB de cod JavaScript pe care serverul de limbaj din editor o încarcă într-un proiect.
plugins Lista de pluginuri pentru serverul de limbaj din editor (completare, erori suplimentare); tsc le ignoră la compilare.
skipLibCheck Nu mai verifică erorile din fișierele .d.ts (ale pachetelor și ale proiectului); compilarea devine mai rapidă.

tsconfig: fișiere JavaScript (2)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
allowJs Permite fișiere .js în proiectul TypeScript: pot fi importate din .ts, sunt copiate în outDir și au tipuri deduse.
checkJs Raportează erorile de tip și în fișierele .js, folosind tipurile deduse și comentariile JSDoc.

tsconfig: opțiuni scoase (compatibilitate) (6)

Tip / Concept / Opțiune tsconfig Descriere și Funcționalitate
charset Opțiune scoasă care alegea codificarea fișierelor sursă; tsc le citește acum ca UTF-8.
importsNotUsedAsValues Opțiuni scoase din TypeScript 5.5 care controlau păstrarea importurilor; înlocuite de verbatimModuleSyntax.
keyofStringsOnly Opțiune scoasă care făcea keyof să dea doar chei string; azi se scrie keyof T & string.
noImplicitUseStrict Opțiune scoasă care oprea scrierea lui „use strict” în fișierele generate.
noStrictGenericChecks Opțiune scoasă care slăbea verificarea compatibilității între tipuri de funcții generice.
suppressExcessPropertyErrors Opțiuni scoase care ascundeau erorile pentru proprietăți în plus și pentru indexare cu any implicit.
Comunitate & Schimb de cunoștințe

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.

Comunitate Adaugă o întrebare sau distribuie un cod

Moderare & Siguranță:

Pentru a menține calitatea și securitatea informațiilor, fiecare întrebare sau fragment de cod/prompt este analizat (manual sau prin moderare asistată de AI) înainte de publicare.