Переиспользуемые type guard-функции

Принципы

• Type guard имеет сигнатуру value is Type и позволяет сужать тип в пределах блока if.
• Внутри функции выполняйте проверки runtime (typeof, instanceof) для подтверждения типа.
• После вызова guard-а TypeScript знает конкретный тип и позволяет использовать его методы.

Пример

function isNumber(x: unknown): x is number {
  return typeof x === 'number';
}

let value: number | string = 3;

if (isNumber(value)) {
  value.toFixed(2); // value: number
}

Практика

• Создавайте библиотеку guard-ов для доменных сущностей, чтобы не копировать проверки везде.
• Возвращайте false по умолчанию и избегайте бросания исключений внутри guard-ов.
• Комбинируйте guard-ы с Array.filter, чтобы получить массив элементов нужного типа.