Дистрибутивность типов в TypeScript: почему Omit схлопывает объединения в пустой объектКратко · дайджест за 21 августа
Кратко≈ 1 мин

Дистрибутивность типов в TypeScript: почему Omit схлопывает объединения в пустой объект

При попытке исключить свойство из объединения типов (union types) с помощью стандартного Omit<T, K> разработчики сталкиваются со скрытой проблемой: TypeScript стирает уникальные поля веток и редуцирует тип к пустому объекту {}. Пустой объект совместим с любым значением (кроме null и undefined), что отключает проверку типов и маскирует ошибки.

Причина в реализации: Omit<T, K> построен через Pick<T, Exclude<keyof T, K>>. Оператор keyof (A | B) возвращает лишь общие ключи веток (keyof A) & (keyof B). Если общих полей нет, keyof вычисляется в never, а Pick возвращает {}.

Для сохранения структуры всех веток операцию делают дистрибутивной:

type DistributiveOmit<T, K extends PropertyKey> = T extends unknown
  ? Omit<T, K>
  : never;

Параметр T в условном типе заставляет компилятор применить Omit изолированно к каждому члену объединения.

Рекомендации:

  1. Использовать DistributiveOmit для объединений;
  2. Включить правило линтера @typescript-eslint/no-empty-object-type;
  3. Проверять сложные типы тестами tsd или expect-type по документации TypeScript Conditional Types.
Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 2