Что такое…

Что такое дженерик (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 — повод присмотреться.

Вот как это использовать на практике:

  1. Видишь в коде any у функции, которая просто передаёт данные дальше? Попроси заменить на дженерик.
  2. Пропали подсказки после точки? Первым делом ищи any в цепочке вызовов.
  3. Просишь ИИ написать утилиту — сразу уточни, что нужен тип без 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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →