Funções de guarda de tipos definidas pelo usuário

Boas-vindas

O tipo de retorno de predicado is

function isString(val: unknown): val is string {
  return typeof val === 'string';
}

Uso de uma proteção de tipo

function process(val: unknown) {
  if (isString(val)) {
    console.log(val.toUpperCase()); // val: string
  }
}

Proteção de tipo para interfaces

interface Cat { meow(): void }
interface Dog { bark(): void }
function isCat(pet: Cat | Dog): pet is Cat {
  return 'meow' in pet;
}

Proteções de tipo para objetos complexos

interface User { name: string; age: number; }
function isUser(val: unknown): val is User {
  return (
    typeof val === 'object' &&
    val !== null &&
    typeof (val as any).name === 'string' &&
    typeof (val as any).age === 'number'
  );
}

Proteções de tipo versus asserções

Array.isArray como proteção de tipo

function flatten(val: string | string[]): string[] {
  return Array.isArray(val) ? val : [val];
}

Proteções de tipo genéricas

function isNonNull<T>(val: T | null | undefined): val is T {
  return val !== null && val !== undefined;
}
const values = [1, null, 2, undefined].filter(isNonNull);
// values: number[]

Funções de asserção

function assertIsString(val: unknown): asserts val is string {
  if (typeof val !== 'string') throw new TypeError('Not a string');
}
assertIsString(input);
console.log(input.toUpperCase()); // narrowed to string

A responsabilidade das proteções de tipo

Proteções de tipo em filter e find

const mixed: (string | null)[] = ['a', null, 'b'];
const strings = mixed.filter((x): x is string => x !== null);
// strings: string[]

Verificação rápida

Recapitulação