При попытке исключить свойство из объединения типов (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 изолированно к каждому члену объединения.
Рекомендации:
- Использовать
DistributiveOmitдля объединений; - Включить правило линтера
@typescript-eslint/no-empty-object-type; - Проверять сложные типы тестами
tsdилиexpect-typeпо документации TypeScript Conditional Types.
![Node.JS [ru]](/api/digests/it_development/daily/20260821/assets/sources/we-use-js.jpg)