Что такое дженерик (generic) — и почему any в коде от ИИ выключает подсказки

Смотри, знакомая картина. Ты просишь ИИ: «напиши функцию, которая берёт первый элемент списка». Он пишет её на TypeScript, всё работает. Ты вызываешь first(users), ставишь точку — и редактор молчит. Ни name, ни email в подсказках.
Код не сломан. Просто ИИ написал тип any, и TypeScript перестал понимать, что вернётся. Чинится это одной буквой в угловых скобках. Эта буква и есть дженерик.
Что такое дженерик — в одну строку
Дженерик (generic) — это переменная для типа. Обычная переменная хранит значение. Дженерик хранит тип: «здесь будет то, что мне передадут».
Вот функция с any:
function first(items: any[]): any {
return items[0];
}
А вот она же с дженериком:
function first<T>(items: T[]): T {
return items[0];
}
Разница — в <T>. Это как подпись на коробке «что положили, то и лежит». Дал массив пользователей — T стал «пользователем». Дал массив чисел — T стал числом.
Как это работает
Самое приятное: T почти никогда не надо писать руками при вызове. TypeScript сам смотрит, что ты передал, и подставляет тип.
const user = first(users); // T = User
const n = first([3, 7, 9]); // T = number
Теперь после user. редактор снова подсказывает name и email. А если ты напишешь n.toUpperCase(), он подчеркнёт ошибку ещё до запуска. У числа такого метода нет.
С any эта ошибка проскочила бы и всплыла уже в браузере. any значит «не проверяй ничего». Дженерик значит «проверь, но подстройся под то, что дали».
Буква T — просто традиция, от слова type. Можно назвать хоть Item. Иногда параметров несколько: <K, V> — «ключ и значение».
Ты уже пользуешься дженериками
Скорее всего, ты встречал их, просто не знал названия:
Array<string>— то же, чтоstring[]. Массив, но тип элементов передан параметром.Promise<User>— обещание, что когда-то придёт пользователь. Всё, что ты делаешь через async/await, завёрнуто в такой тип.useState<User | null>(null)в React. Без<...>React решил бы, что в состоянии навсегда лежит толькоnull.Map<string, number>— словарь, где ключи строки, а значения числа.
Везде одна идея: контейнер один, а содержимое разное. И контейнер помнит, что именно внутри.
Дженерик в твоём собственном коде
Самое частое место, где новичку пригодится свой дженерик, — ответ от сервера. У всех запросов обёртка одинаковая, а начинка разная:
type ApiResponse<T> = {
data: T;
error: string | null;
};
const res: ApiResponse<User[]> = await getUsers();
Одно описание — на все запросы приложения. Для списка пользователей T — это массив пользователей, для заказа — заказ. И после res.data[0]. редактор снова знает все поля.
Без дженерика пришлось бы писать отдельный тип под каждый запрос. Или сдаться и поставить any — и снова потерять подсказки.
Зачем это тебе
Ты, скорее всего, не будешь писать сложные дженерики сам. Но ты будешь читать код от ИИ. И тут дженерик — хороший знак, а any — повод присмотреться.
Вот как это использовать на практике:
- Видишь в коде
anyу функции, которая просто передаёт данные дальше? Попроси заменить на дженерик. - Пропали подсказки после точки? Первым делом ищи
anyв цепочке вызовов. - Просишь ИИ написать утилиту — сразу уточни, что нужен тип без
any.
Сделай функцию, которая берёт первый элемент массиваНапиши на TypeScript функцию first, которая возвращает первый элемент массива. Без any: используй дженерик, чтобы тип результата совпадал с типом элементов. Для пустого массива возвращай undefined и отрази это в типе. Покажи два вызова: с массивом чисел и с массивом объектов User.Обрати внимание на пустой массив. Честная версия — T | undefined, потому что у пустого списка первого элемента нет. Хороший тип не врёт про такие случаи. Подробнее о том, как TypeScript страхует от подобного, — в разборе TypeScript или JavaScript.
Дженерик и any — это не одно и то же?
Нет. any выключает проверку целиком: можно вызвать что угодно, ошибки не будет. Дженерик проверку оставляет, просто тип выясняется в момент вызова.
Почему ИИ так часто пишет any?
Так быстрее всего убрать красное подчёркивание, а ИИ старается выдать код, который компилируется. Попроси прямо: «без any». Многие команды ещё и включают правило линтера, которое запрещает any.
Есть ли дженерики в обычном JavaScript?
Нет, это слой TypeScript. В JavaScript типов при записи кода нет вовсе, поэтому и переменных для типов нет. После сборки все <T> просто стираются.
Можно ли ограничить, что подходит под T?
Да, словом extends. Например, <T extends { id: string }> значит: «любой объект, но у него обязательно есть поле id». Удобно, когда функция ищет запись по id.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





