Fonctions de garde de types définies par l’utilisateur

Bienvenue

Le type de retour prédicat is

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

Utilisation d’une garde de type

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

Garde de type pour les interfaces

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

Gardes de type pour les objets complexes

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'
  );
}

Gardes de type ou assertions

Array.isArray comme garde de type

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

Gardes de type génériques

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[]

Fonctions d’assertion

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

La responsabilité des gardes de type

Gardes de type dans filter et find

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

Vérification rapide

Récapitulatif