re:re:actable
Урок 021 минута чтения

Generic без extends

На этой странице
Кратко

Generic без extends не всегда ошибка, но становится антипаттерном, если код внутри требует конкретной формы значения. В таком случае ограничение нужно указать явно.

Вопрос

Почему generic без extends может быть проблемой?

Нормальный generic без ограничения

Если функция просто сохраняет тип и не обращается к специфичным полям, ограничение не нужно.

function identity<T>(value: T): T {
  return value;
}

Здесь T действительно может быть любым.

Проблемный пример

function getId<T>(value: T): string {
  // return value.id; // ошибка
  return "";
}

Код хочет использовать id, но generic не сообщает TypeScript, что id существует.

Правильное ограничение

function getId<T extends { id: string }>(value: T): string {
  return value.id;
}
 
getId({ id: "1", name: "Анна" });
// getId({ name: "Анна" }); // ошибка

Ограничение ключами

function getProperty<T, K extends keyof T>(object: T, key: K): T[K] {
  return object[key];
}

Это лучше, чем принимать произвольную строку в качестве ключа.

Что важно помнить

  • Дженерик без ограничения не дает использовать свойства T внутри функции.
  • Лишний дженерик, который используется один раз, ничего не связывает — замените его на unknown.
  • Ограничивайте T минимально необходимой формой, а не конкретным типом.
  • Правило @typescript-eslint/no-unnecessary-type-parameters находит ненужные параметры типа.

Мини-шпаргалка

  • Generic без extends нормален, если T может быть любым.
  • Если нужен доступ к полям, добавляй ограничение.
  • T extends { id: string } описывает минимальную форму.
  • K extends keyof T ограничивает ключи объекта.

Документация

TypeScript Handbook: Generic Constraints, typescript-eslint: no-unnecessary-type-parameters.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам