Benutzerdefinierte Type-Guard-Funktionen

Willkommen

Der is-Prädikat-Rückgabetyp

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

Einen Typwächter verwenden

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

Typwächter für Schnittstellen

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

Typwächter für komplexe Objekte

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

Typwächter im Vergleich zu Assertions

Array.isArray als Typwächter

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

Generische Typwächter

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

Assertionsfunktionen

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

Die Verantwortung von Typwächtern

Typwächter in filter und find

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

Kurzer Test

Zusammenfassung