Skip to content

类型 Guard Toolkit

中等 约 20 分钟

你将构建什么

设置的 类型 guard 函数 (isString, isNumber, isObject, isArray, isInstanceOf) 那个 use `x 是 T` predicate for automatic 类型 narrowing.

学习目标

  • 编写用户-定义类型 guards 使用 `是` predicate
  • 组合类型 guards for 复杂类型
  • Narrow union 类型 safely at 运行时
  • 构建 reusable validation toolkit

前置要求

  • 类型 guards
  • Union 类型
  • typeof and instanceof

步骤

  1. 1

    编写 primitive 类型 guards

    创建类型 guards for primitives using typeof. 返回类型 x 是 T tells TypeScript 到 narrow 类型当 guard 返回真.

    代码
    function isString(x: unknown): x is string { return typeof x === "string"; }
    function isNumber(x: unknown): x is number { return typeof x === "number"; }
    function isBoolean(x: unknown): x is boolean { return typeof x === "boolean"; }

    预期结果

    Three 类型 guards. 之后 isString(x) 返回真, x 是 narrowed 到字符串.

  2. 2

    编写对象 and 数组 guards

    创建 guards for 对象 and 数组. For 数组, 检查数组.isArray. For 对象, 验证 typeof and 空 exclusion.

    代码
    function isObject(x: unknown): x is Record<string, unknown> {
      return typeof x === "object" && x !== null && !Array.isArray(x);
    }
    function isArray(x: unknown): x is unknown[] {
      return Array.isArray(x);
    }

    预期结果

    对象 and 数组类型 guards 那个 properly narrow 类型.

  3. 3

    构建组合 validator

    Use 类型 guards together 到验证 unknown 数据 and narrow 它到 特定 shape. 这个模式是 常见当 parsing JSON.

    代码
    function parseUser(data: unknown): { name: string; age: number } | null {
      if (!isObject(data)) return null;
      if (!isString(data.name)) return null;
      if (!isNumber(data.age)) return null;
      return { name: data.name, age: data.age };
    }

    预期结果

    函数那个验证 unknown 数据 and 返回输入对象 or 空.

  4. 4

    添加类型守卫与运行时检查

    编写类型守卫函数(user-defined type guard)在运行时验证数据形状,结合 unknown 类型安全处理外部输入。类型守卫让 TypeScript 在运行时也有类型安全。

    代码
    type User = { id: number; name: string };
    
    function isUser(value: unknown): value is User {
      if (typeof value !== "object" || value === null) return false;
      const obj = value as Record<string, unknown>;
      return typeof obj.id === "number" && typeof obj.name === "string";
    }
    
    // Usage with unknown input
    const data: unknown = JSON.parse(rawJson);
    if (isUser(data)) {
      console.log(data.name); // TS knows data is User here
    } else {
      console.error("Invalid user data");
    }

    预期结果

    isUser 返回 true 时 TS 将 data 收窄为 User 类型;非法数据走 else 分支。

  5. 5

    添加泛型工具函数

    编写泛型工具函数(如 deepFreeze、groupBy)增强类型安全的复用能力。泛型让工具函数适用于多种类型而不丢失类型信息。

    代码
    function groupBy<T, K extends string | number>(
      items: T[],
      keyFn: (item: T) => K
    ): Record<K, T[]> {
      const result = {} as Record<K, T[]>;
      for (const item of items) {
        const key = keyFn(item);
        (result[key] ??= []).push(item);
      }
      return result;
    }
    
    // Usage
    const byAge = groupBy(users, u => u.age);

    预期结果

    groupBy 对任意类型数组按键分组,返回类型安全的 Record。

自己动手试试

你学到了什么

你构建 reusable 类型 guards 那个 narrow 类型 at 运行时. x 是 T predicate 是键 — 它 bridges 运行时检查到 编译-时间类型 safety, 启用 TypeScript 到 narrow 类型内部如果块 automatically.

查阅不认识的术语

新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。

查看术语表

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回主题