Урок 013 минуты чтения
Что такое дженерики и чем они отличаются от any
На этой странице
Кратко
Дженерики (generics) — параметры типов: функция, тип или класс принимает тип как аргумент (<T>) и сохраняет связь между входом и выходом. function first<T>(items: T[]): T вернет string для string[] и User для User[]. В отличие от any, который стирает информацию о типе, дженерик ее сохраняет и позволяет писать универсальный, но типобезопасный код.
Вопрос
Что такое дженерики в TypeScript и зачем они нужны? Чем дженерики отличаются от any?
Проблема без дженериков
function firstNumber(items: number[]): number { return items[0]; }
function firstString(items: string[]): string { return items[0]; }
// дублирование для каждого типа
function firstAny(items: any[]): any { return items[0]; }
const value = firstAny(["a", "b"]); // any — тип потерян
value.toFixed(); // компилируется, падает в runtimeС дженериком
function first<T>(items: T[]): T | undefined {
return items[0];
}
const name = first(["Анна", "Иван"]); // string | undefined
const user = first(users); // User | undefined
name?.toFixed(); // ошибка: toFixed не существует у stringT выводится из аргумента автоматически, явно писать first<string>(...) обычно не нужно.
Дженерики и any
any | Дженерик <T> | |
|---|---|---|
| Принимает любой тип | да | да |
| Помнит, какой тип передали | нет | да |
| Связь вход → выход | теряется | сохраняется |
| Проверка операций | отключена | работает (по ограничениям T) |
| Автодополнение | нет | есть |
function identityAny(value: any): any { return value; }
function identity<T>(value: T): T { return value; }
identityAny(42).toUpperCase(); // компилируется — ошибка в runtime
identity(42).toUpperCase(); // ошибка компиляцииГде встречаются
const list: Array<string> = [];
const map = new Map<string, User>();
const promise: Promise<User> = fetchUser();
const [count, setCount] = useState<number>(0);
const ref = useRef<HTMLInputElement>(null);
type ApiResponse<T> = { data: T; error: string | null };
interface Repository<T> {
findById(id: string): Promise<T | null>;
save(entity: T): Promise<void>;
}
class Stack<T> {
#items: T[] = [];
push(item: T) { this.#items.push(item); }
pop(): T | undefined { return this.#items.pop(); }
}Именование
T, U, K, V — традиция для коротких дженериков; для сложных лучше говорящие имена: TItem, TResponse, TKey.
Что важно помнить
- Дженерик полезен, только если
Tсвязывает несколько мест: параметр и результат, два параметра.function log<T>(x: T): void— лишний дженерик, хватитunknown. - Ограничения (
T extends ...) позволяют использовать свойстваTвнутри функции. - В
.tsxстрелочный дженерик пишут как<T,>(x: T) => xили<T extends unknown>, чтобы не путать с JSX. - Типы дженериков стираются в runtime:
Tнельзя проверить черезtypeofилиinstanceof.
Мини-шпаргалка
- Дженерик — параметр типа
<T>. - Сохраняет связь между типами входа и выхода.
anyтеряет тип, дженерик — нет.Tобычно выводится автоматически.Array<T>,Promise<T>,Map<K, V>,useState<T>— всё дженерики.
Документация
TypeScript Handbook: Generics, TypeScript Handbook: Generic Functions.
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.