...
Eroare TypeScript · Generice

error TS2344: Type 'string' does not satisfy the constraint '{ id: number; }'.

Pe scurt

Ai dat unui tip generic un argument care nu respectă constrângerea din extends (aici T trebuie să aibă câmpul id: number, iar string nu are). Folosește un tip care respectă constrângerea sau, dacă trebuie să accepte și alte tipuri, relaxează constrângerea.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un parametru generic poate avea o constrângere: type Tabel<T extends { id: number }> înseamnă „T poate fi orice tip, cu condiția să aibă un câmp id numeric”. TS2344 apare când scrii explicit un argument care nu îndeplinește condiția: Tabel<string>, Tabel<{ nume: string }>.

Mesajul are mereu forma „Type 'X' does not satisfy the constraint 'Y'”, uneori cu detalii pe a doua linie (ce câmp lipsește). Apare la tipuri generice (Pick<T, K> cu o cheie care nu există: Type '"nume" | "stoc"' does not satisfy the constraint 'keyof Produs'), la interfețe și la apelurile de funcții în care scrii argumentul de tip explicit, f<string>(...).

Pentru apelurile în care TypeScript deduce T din argumente, eroarea apare de obicei ca TS2345 sau TS2353 la argument. Repararea e aceeași: tipul trebuie să aibă ce cere constrângerea.

De ce apare: cauzele frecvente

1Tipul nu are câmpul cerut

Greșit
TypeScript
type Tabel<T extends { id: number }> = T[];
type TabelNume = Tabel<{ nume: string }>;
Corect
TypeScript
type Tabel<T extends { id: number }> = T[];
type TabelNume = Tabel<{ id: number; nume: string }>;

Tipul dat ca argument trebuie să aibă câmpul id numeric.

2Cheie inexistentă în Pick

Greșit
TypeScript
interface Produs { nume: string; pret: number }
type Rezumat = Pick<Produs, "nume" | "stoc">;
Corect
TypeScript
interface Produs { nume: string; pret: number }
type Rezumat = Pick<Produs, "nume" | "pret">;

Pick cere chei din keyof Produs; "stoc" nu există în interfață.

3Constrângere prea strictă

Greșit
TypeScript
function lungime<T extends string>(x: T) { return x.length; }
lungime<string[]>(["a"]);
Corect
TypeScript
function lungime<T extends { length: number }>(x: T) { return x.length; }
lungime<string[]>(["a"]);

Dacă funcția are nevoie doar de length, constrângerea poate cere doar asta, iar string-urile și tablourile trec.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2344: Type 'Categorie' does not satisfy the constraint 'CuId', pentru că tipul Categorie nu are câmpul id cerut de Depozit. Adaugă în interfața Categorie câmpul id: number, ca programul să afișeze Categoria 2: Papetărie.

Codul care dă eroarea
TypeScript
interface CuId {
  id: number;
}
class Depozit<T extends CuId> {
  private elemente: T[] = [];
  adauga(e: T): void {
    this.elemente.push(e);
  }
  dupaId(id: number): T | undefined {
    return this.elemente.find((e) => e.id === id);
  }
}
interface Categorie {
  nume: string;
}
const categorii = new Depozit<Categorie>();
categorii.adauga({ nume: "Carte" });
categorii.adauga({ nume: "Papetărie" });
console.log(`Categoria 2: ${categorii.dupaId(2)?.nume}`);
După reparație, programul afișează
Categoria 2: Papetărie
Indiciu

Constrângerea T extends CuId cere ca T să aibă un id numeric.

Alte forme ale mesajului

  • error TS2344: Type '"nume" | "stoc"' does not satisfy the constraint 'keyof Produs'.

Cum o eviți pe viitor

  • Pune constrângeri care cer doar ce folosește codul generic (de exemplu { id: number }, { length: number }), nu tipuri concrete.
  • Lasă TypeScript să deducă argumentele de tip la apel; scrie-le explicit doar când nu se pot deduce.
  • La Pick și Omit folosește autocomplete pentru chei: editorul îți arată doar cheile valide.

Întrebări frecvente

Ce înseamnă extends la generice?

Nu e moștenire ca la clase, ci „este compatibil cu”: T extends { id: number } acceptă orice tip care are cel puțin câmpul id numeric.

De ce Omit<Produs, "stoc"> nu dă eroare, dar Pick da?

Pentru că Omit acceptă orice chei (K extends keyof any), pe când Pick cere K extends keyof T. O cheie greșită în Omit pur și simplu nu scoate nimic.

Erori înrudite

← Toate erorile TypeScript

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață TypeScript de la zero, cu exerciții la fiecare lecție

Curs TypeScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.