...
Eroare TypeScript · Generice

error TS2322: Type 'string' is not assignable to type 'T'. 'T' could be instantiated with an arbitrary type which could be unrelated to 'string'.

Pe scurt

O funcție generică promite să întoarcă T, dar tu întorci o valoare concretă (un string, null, {}). Cel care apelează alege T, deci valoarea ta poate să nu fie de acel tip. Întoarce ceva derivat din parametrii de tip T sau schimbă tipul de întoarcere (de exemplu T | undefined).

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

Ce înseamnă

Într-o funcție function f<T>(...): T, apelantul decide ce este T: f<number>(), f<Produs>() și așa mai departe. Funcția trebuie să funcționeze corect pentru orice alegere. Dacă în corp scrii return "implicit" sau return null, valoarea ar fi corectă doar pentru unele tipuri T, nu pentru toate, deci TypeScript refuză. A doua parte a mesajului explică exact asta: T poate fi orice tip, posibil fără legătură cu string.

O variantă apare când T are o constrângere (T extends { id: number }) și întorci un obiect literal { id: 1 }: obiectul respectă constrângerea, dar T poate fi un subtip cu mai multe câmpuri.

Reparațiile: întorci doar valori care vin din parametrii de tip T (elemente din lista primită, valoarea implicită primită ca argument), schimbi tipul de întoarcere în T | undefined / T | null, sau renunți la generic dacă funcția lucrează de fapt cu un tip concret.

De ce apare: cauzele frecvente

1Valoare lipsă întoarsă ca null

Greșit
TypeScript
function primul<T>(xs: T[]): T {
  return xs.length > 0 ? xs[0] : null;
}
Corect
TypeScript
function primul<T>(xs: T[]): T | null {
  return xs.length > 0 ? xs[0] : null;
}

Tipul de întoarcere spune acum cinstit că rezultatul poate lipsi.

2Valoare implicită concretă

Greșit
TypeScript
function citeste<T>(v: T | undefined): T {
  return v ?? "gol";
}
Corect
TypeScript
function citeste<T>(v: T | undefined, implicit: T): T {
  return v ?? implicit;
}

Valoarea implicită vine de la apelant, deci are sigur tipul T.

3Obiect literal pentru un T constrâns

Greșit
TypeScript
function nou<T extends { id: number }>(): T {
  return { id: 1 };
}
Corect
TypeScript
function nou<T extends { id: number }>(baza: Omit<T, "id">): T {
  return { ...baza, id: 1 } as T;
}

{ id: 1 } nu are restul câmpurilor lui T; le primești de la apelant.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2322: Type 'undefined' is not assignable to type 'T'. Funcția ultimul întoarce undefined pentru o listă goală. Schimbă tipul de întoarcere ca programul să compileze și să afișeze 30 și apoi nimic.

Codul care dă eroarea
TypeScript
function ultimul<T>(xs: T[]): T {
  if (xs.length === 0) {
    return undefined;
  }
  return xs[xs.length - 1];
}
console.log(ultimul([10, 20, 30]));
console.log(ultimul<string>([]) ?? "nimic");
După reparație, programul afișează
30
nimic
Indiciu

Tipul de întoarcere trebuie să includă și undefined: T | undefined.

Alte forme ale mesajului

  • error TS2322: Type 'null' is not assignable to type 'T'. 'T' could be instantiated with an arbitrary type which could be unrelated to 'null'.
  • error TS2322: Type '{ id: number; }' is not assignable to type 'T'. '{ id: number; }' is assignable to the constraint of type 'T', but 'T' could be instantiated with a different subtype of constraint '{ id: number; }'.

Cum o eviți pe viitor

  • Gândește o funcție generică din perspectiva apelantului: trebuie să meargă pentru orice T.
  • Valorile de tip T din corp trebuie să provină din parametri, nu din literale scrise în funcție.
  • Când rezultatul poate lipsi, include undefined sau null în tipul de întoarcere.
  • Dacă funcția are nevoie de un tip concret, nu o face generică.

Întrebări frecvente

De ce as T face eroarea să dispară?

as T e o aserțiune: îi spui compilatorului să aibă încredere în tine. Uneori e justificat, dar pentru return "text" as T codul ar fi greșit când T e number. Folosește-l doar când chiar poți garanta tipul.

Ce înseamnă „different subtype of constraint”?

Constrângerea T extends { id: number } spune doar ce câmpuri are cel puțin T. Apelantul poate alege un T cu mai multe câmpuri, de exemplu Produs, iar { id: 1 } nu ar fi un Produs complet.

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.