Когда похожие объявления типов TypeScript повторяются, возникает желание вычислять результирующий тип из входного. Важнее сокращения текста ясность отношений типов для читателя. На примере вымышленной службы уведомлений о доставке рассмотрим условные типы и infer, отделяя их от проверки фактической корректности внешних данных.
1. Условный тип — ветвление с типом на входе
Официальная документация условных типов объясняет выбор результирующего типа по условию extends. Пример создаёт булев литеральный тип в зависимости от того, строковый ли входной тип. Это не функция, проверяющая строку при выполнении.
type IsText<T> = T extends string ? true : false;
type NameIsText = IsText<'parcel'>; // true
type CountIsText = IsText<3>; // false
Предположим, функция уведомления получает строковый идентификатор, а внутренняя обработка — числовой. До применения условного типа следует объяснить, почему они различаются. При разном смысле полезны отдельные имена; при разнице лишь записи может быть понятнее единый входной формат. Не скрывайте неопределённость модели данных типовыми приёмами.
При проверке типов запишите пары ожидаемого входа и результата. Небольшие примеры строк, чисел, объединений и неожиданных входов облегчат чтение сложного объявления. Сопоставьте результат в комментарии с типом, выведенным редактором. Естественное имя типа не гарантирует ожидаемого вычисления.
2. Распределение объединений меняет смысл массива
Когда параметр типа стоит непосредственно слева от условия, оно распределяется по каждому члену объединения. Чтобы считать объединение целиком, сравните вариант с оборачиванием в квадратные скобки.
type SeparateLists<T> = T extends unknown ? T[] : never;
type Together<T> = [T] extends [unknown] ? T[] : never;
type A = SeparateLists<string | number>; // string[] | number[]
type B = Together<string | number>; // (string | number)[]
const a: A = ['a', 'b'];
const b: B = ['a', 1];
Первый результат — массив только строк либо только чисел. Второй допускает строки и числа в одном массиве. Выбор зависит от того, должен ли весь список доставки содержать коды одного вида или каждый элемент может иметь иной вид. Квадратные скобки видны в обоих случаях, но контракты массивов различаются.
При практической проблеме вместо чтения всего сложного вспомогательного типа попробуйте по одному входному члену. Сравните результаты для строки, числа и их объединения. Когда ясно, нужно ли распределение, можно объяснить и добавление скобок. В записи проверки полезно оставить не только итоговый тип, но и примеры допустимых значений.
3. infer даёт имя типу внутри структуры
В условном типе infer позволяет назвать часть сопоставляемой структуры. Этот небольшой тип снимает один уровень Promise.
type OneResult<T> = T extends Promise<infer Value> ? Value : T;
type Parcel = OneResult<Promise<{ tracking: string }>>;
type ParcelList = OneResult<Promise<string[]>>;
Код не запускает асинхронную работу и не ждёт её. Он выражает форму результата на этапе компиляции. Имя вроде Resolved может создать впечатление, что значение уже пришло, поэтому учитывайте контекст применения типа. Ожидание при выполнении по-прежнему требуется обрабатывать асинхронным кодом.
Если нужен рекурсивно ожидаемый результат, прежде чем расширять одноуровневый учебный пример, проверьте стандартный вспомогательный тип Awaited. Простота учебного примера и требования общего инструмента различны. Вводя новую утилиту в команде, опишите входы, где её результат отличается от стандартного типа, и необходимость этих отличий.
4. Соединять имена событий шаблонными литералами
Типы шаблонных литералов выражают комбинации строковых литералов как тип. В службе доставки примером служат имена событий из области и действия.
type Scope = 'parcel' | 'address';
type Action = 'created' | 'updated';
type EventName = `${Scope}:${Action}`;
const event: EventName = 'parcel:created';
Опечатку можно найти при компиляции, но допустимость всех комбинаций в реальной службе — другой вопрос. Например, если поддерживается только событие удаления адреса, простое произведение областей и действий может неточно выражать правила. Сначала рассмотрите явное соответствие разрешённых событий и payload.
С ростом числа событий важна и доступность реальных имён читателю. Вместо нескольких уровней автоматического комбинирования можно собрать передаваемые внешним системам имена в одном файле. Сравните, как новичок команды обнаружит неверное событие до и после абстракции. Точность типов и удобство использования оцениваются вместе.
5. Внешний JSON проверяют во время выполнения
Присвоение ответу API типа User или Parcel не гарантирует соответствие фактической структуры. Получим внешний ввод как unknown и проверим нужные поля.
function hasTracking(value: unknown): value is { tracking: string } {
return typeof value === 'object' && value !== null
&& 'tracking' in value && typeof value.tracking === 'string';
}
const incoming: unknown = { tracking: 'DEMO-001' };
if (hasTracking(incoming)) console.log(incoming.tracking);
Проверка устанавливает лишь то, что tracking — строка. Она не подтверждает существование накладной и право пользователя видеть эту доставку. Сужение типов, бизнес-правила и проверка прав — разные обязанности. Официальный раздел Narrowing объясняет сужение информации о типах через условия.
6. Небольшой порядок выбора типовых инструментов
Сначала запишите два допустимых и два недопустимых реальных значения. Затем выразите смысл обычным объединением и явным объектным объявлением. Если повторяющиеся связи остались, причина применения условного типа или infer станет яснее. При сильном росте времени чтения можно извлечь только общее, оставив остальное обычными типами.
Наконец, выполняйте проверку типов и проверки времени выполнения отдельно. Проверка отказа компилятора от неверного имени события дополняет проверку понятной ошибки программы при пропущенном сервером поле. Лишь связав результаты небольших примеров с реальными границами ввода, можно использовать преобразования типов для безопасного проектирования приложения.