Genéricos permitem que você escreva código reutilizável parametrizado por um tipo — uma "variável de tipo" preenchida quando o código é usado. Eles oferecem reutilização sem perder segurança de tipo (a alternativa, any, a perde).
(): { arr[]; }
first<T>(: T[]): T { arr[]; }
n = ([, , ]);
s = ([, ]);
T é um espaço reservado; TypeScript infere a partir do argumento, então o tipo de retorno é preciso — first([1,2]) fornece um number, não any.
interface ApiResponse<T> { data: T; status: number; }
const res: ApiResponse<User> = await getUser(); // res.data is User
class Box<T> {
constructor(private value: T) {}
get(): T { return this.value; }
}
const box = new Box(123); // Box<number>
function pair<K, V>(k: K, v: V): [K, V] { return [k, v]; }
pair("id", 42); // [string, number]
Genéricos alimentam quase todas as abstrações reutilizáveis em TypeScript: Array<T>, Promise<T>, Map<K,V>, useState<T> do React, utilitários de busca de dados e coleções.
Eles permitem que uma implementação funcione para muitos tipos enquanto preservam as informações de tipo completas de ponta a ponta — a relação entre tipos de entrada e saída é mantida, não apagada.