User-defined type guard

User-defined type guard, bir fonksiyonun dönüş türü olarak x is T biçimindeki bir koşul (predicate) kullanır. Bu, fonksiyon true döndürdüğünde TypeScript'in parametreyi T türüne daraltmasını sağlar. unknown gibi geniş türleri güvenli şekilde işlemenin yoludur.

function isString(x: unknown): x is string {
  return typeof x === "string";
}

function upper(v: unknown): string {
  if (isString(v)) {
    return v.toUpperCase();  // v: string
  }
  return "";
}

type guard'lar unknown türüyle çalışırken özellikle yararlıdır. Bir değerin yapısı bilinmediğinde, guard fonksiyonuyla güvenli daraltma yapılır. type guard'ı yeniden kullanılabilir yapmak, daraltma mantığını tek yerde toplar.

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

function double(v: unknown): number {
  if (isNumber(v)) {
    return v * 2;  // v: number
  }
  return 0;
}