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>.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un tip generic e un „șablon” de tip care are nevoie de unul sau mai mulți parametri: Array<T> e „tablou de T”, Map<K, V> e „dicționar de la K la V”, Promise<T> e „promisiune de T”. Fără parametri, tipul e incomplet, iar mesajul îți spune câți lipsesc: „requires 1 type argument(s)”, „requires 2 type argument(s)”.
Apare des când vii din JavaScript sau Java vechi (List fără <...>), la Promise fără tip în semnătura unei funcții async, la Record cu un singur argument și la tipurile tale generice (ApiResponse<T>) folosite fără T.
Diferența față de funcțiile generice: la apelul unei funcții (identitate(5)) TypeScript deduce singur T. La scrierea unui tip (adnotare, interfață), trebuie să-l dai tu, cu excepția cazului în care tipul are o valoare implicită (type Raspuns<T = unknown>).
De ce apare: cauzele frecvente
1Array fără tipul elementelor
const note: Array = [9, 10];const note: Array<number> = [9, 10];Array<number> sau forma scurtă number[].
2Map cu un singur argument
const stoc: Map<string> = new Map();const stoc: Map<string, number> = new Map();Map are nevoie de tipul cheii și de tipul valorii (aici mesajul spune „requires 2 type argument(s)”).
3Tipul tău generic folosit fără parametru
interface Raspuns<T> { ok: boolean; date: T }
const r: Raspuns = { ok: true, date: 5 };interface Raspuns<T> { ok: boolean; date: T }
const r: Raspuns<number> = { ok: true, date: 5 };Spui ce tip au datele. Alternativ, dai o valoare implicită: interface Raspuns<T = unknown>.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2314: Generic type 'Raspuns<T>' requires 1 type argument(s). Completează tipul variabilei r cu tipul datelor (o listă de produse), ca programul să afișeze OK: 2 produse, primul Pix.
interface Produs {
nume: string;
pret: number;
}
interface Raspuns<T> {
ok: boolean;
date: T;
}
const r: Raspuns = {
ok: true,
date: [{ nume: "Pix", pret: 3 }, { nume: "Caiet", pret: 8 }],
};
console.log(`${r.ok ? "OK" : "Eroare"}: ${r.date.length} produse, primul ${r.date[0].nume}`);OK: 2 produse, primul Pix
Indiciu
Datele din răspuns sunt un Produs[], deci tipul e Raspuns<Produs[]>.
Reparația
interface Produs {
nume: string;
pret: number;
}
interface Raspuns<T> {
ok: boolean;
date: T;
}
const r: Raspuns<Produs[]> = {
ok: true,
date: [{ nume: "Pix", pret: 3 }, { nume: "Caiet", pret: 8 }],
};
console.log(`${r.ok ? "OK" : "Eroare"}: ${r.date.length} produse, primul ${r.date[0].nume}`);De ce merge
Raspuns<T> e un șablon: câmpul date are tipul T, pe care trebuie să-l alegi când folosești tipul. Fără argument, TypeScript nu știe ce e în date. Cu Raspuns<Produs[]>, date devine un tablou de produse, deci r.date.length și r.date[0].nume sunt verificate. Aceeași interfață poate fi folosită pentru orice alt răspuns, de exemplu Raspuns<number> pentru un total.
Alte forme ale mesajului
error TS2314: Generic type 'Map<K, V>' requires 2 type argument(s).error TS2314: Generic type 'Promise<T>' requires 1 type argument(s).
Cum o eviți pe viitor
- Pentru tablouri, folosește forma scurtă
number[]: e mai greu de uitat parametrul. - La tipurile tale generice, pune o valoare implicită (
<T = unknown>) dacă există un caz general rezonabil. - Lasă TypeScript să deducă tipul la variabile cu valoare inițială (
const note = [9, 10]); adnotează doar unde ajută.
Întrebări frecvente
Care e diferența între Array<number> și number[]?
Niciuna, sunt același tip. number[] e mai scurt și mai folosit; Array<...> e mai lizibil la tipuri compuse, de exemplu Array<string | number>.
De ce la apelul unei funcții generice nu trebuie să scriu <T>?
Pentru că TypeScript deduce T din argumente. La adnotarea unui tip nu există argumente din care să deducă, deci îl scrii tu.
Erori înrudite
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. 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 TS1064: The return type of an async function or method must be the global Promise<T> type. Did you mean to write 'Promise<number>'? O funcție async întoarce întotdeauna un Promise, deci tipul de return nu poate fi number sau string simplu. Scrie Promise<number> (cum îți sugerează mesajul) și folosește await la apel ca să obții valoarea. Î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.
