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

T extends never

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

T extends never часто ведет себя неожиданно из-за дистрибутивности conditional types. Если T равен never, условие может вернуть тоже never, а не ожидаемые true или false.

Вопрос

Что означает T extends never?

Интуитивный пример

type IsNever<T> = T extends never ? true : false;
 
type A = IsNever<string>;
// false
 
type B = IsNever<never>;
// never, а не true

Почему так? Conditional type распределяется по union. А never можно представить как пустой union, по которому нечего распределять.

Правильная проверка на never

Чтобы отключить дистрибутивность, заворачивают T в tuple.

type IsNever<T> = [T] extends [never] ? true : false;
 
type A = IsNever<string>;
// false
 
type B = IsNever<never>;
// true

Где это встречается

Проверка на never нужна в advanced utility-типах, когда нужно обработать "пустой" результат вычислений.

type FallbackIfNever<T, Fallback> = [T] extends [never] ? Fallback : T;
 
type Result = FallbackIfNever<Extract<"a", "b">, "none">;
// "none"

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

  • T extends never с голым T распределяется: для never на входе результат — never, а не true.
  • Правильная проверка на never: [T] extends [never] ? true : false.
  • never как ограничение (<T extends never>) почти бесполезно — подходит только сам never.
  • Такие конструкции встречаются в библиотечных типах; в прикладном коде редки.

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

  • T extends never с голым T дистрибутивен.
  • Для never результат может стать never.
  • Проверяй через [T] extends [never].
  • Это важный нюанс conditional types.

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

TypeScript Handbook: Distributive Conditional Types.

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

Поиск

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