error TS2344: Type 'string' does not satisfy the constraint '{ id: number; }'.
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
type Tabel<T extends { id: number }> = T[];
type TabelNume = Tabel<{ nume: string }>;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
interface Produs { nume: string; pret: number }
type Rezumat = Pick<Produs, "nume" | "stoc">;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ă
function lungime<T extends string>(x: T) { return x.length; }
lungime<string[]>(["a"]);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ă 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.
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}`);Categoria 2: Papetărie
Indiciu
Constrângerea T extends CuId cere ca T să aibă un id numeric.
Reparația
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 {
id: number;
nume: string;
}
const categorii = new Depozit<Categorie>();
categorii.adauga({ id: 1, nume: "Carte" });
categorii.adauga({ id: 2, nume: "Papetărie" });
console.log(`Categoria 2: ${categorii.dupaId(2)?.nume}`);De ce merge
Clasa Depozit caută elementele după e.id, de aceea parametrul generic are constrângerea T extends CuId: acceptă orice tip, cu condiția să aibă un id numeric. Categorie nu avea câmpul, deci nu respecta constrângerea. Cu id: number adăugat în interfață (și completat la cele două obiecte), Depozit<Categorie> e valid, iar dupaId(2) găsește categoria „Papetărie”.
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șiOmitfoloseș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
error TS2339: Property 'length' does not exist on type 'T'. Într-o funcție generică, T poate fi orice tip, deci TypeScript nu garantează că are length (sau alt câmp). Adaugă o constrângere care cere câmpul: <T extends { length: number }>, sau <T extends Produs> pentru câmpurile unui tip. error TS2314: Generic type 'Array<T>' requires 1 type argument(s). Ai folosit un tip generic (Array, Map, Promise, Record sau unul al tău) fără să spui tipul din interior. Adaugă argumentul între < >, de exemplu Array<number> sau number[], Map<string, number>, Promise<void>. error TS2353: Object literal may only specify known properties, and 'culoare' does not exist in type 'Produs'. Ai scris într-un obiect literal un câmp pe care tipul țintă nu îl are (aici culoare). De obicei e un nume greșit sau un câmp uitat în interfață: corectează numele ori adaugă câmpul în tip. Î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.
