...
Eroare TypeScript · Generice

error TS2314: Generic type 'Array<T>' requires 1 type argument(s).

Pe scurt

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

Greșit
TypeScript
const note: Array = [9, 10];
Corect
TypeScript
const note: Array<number> = [9, 10];

Array<number> sau forma scurtă number[].

2Map cu un singur argument

Greșit
TypeScript
const stoc: Map<string> = new Map();
Corect
TypeScript
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

Greșit
TypeScript
interface Raspuns<T> { ok: boolean; date: T }
const r: Raspuns = { ok: true, date: 5 };
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
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}`);
După reparație, programul afișează
OK: 2 produse, primul Pix
Indiciu

Datele din răspuns sunt un Produs[], deci tipul e Raspuns<Produs[]>.

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

← 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.