Skip to content

运行时数据 Validator

中等 约 25 分钟

你将构建什么

验证函数那个 takes Schema 定义 and unknown 数据, 检查每个字段, and 返回要么输入对象 or 列表的 错误.

学习目标

  • Bridge 运行时 validation 到编译-时间类型
  • 构建 Schema 定义系统
  • 返回输入成功 or 错误 results
  • 练习 discriminated unions for results

前置要求

  • 类型 guards
  • Discriminated unions
  • Conditional 类型

步骤

  1. 1

    定义 result 类型

    Use discriminated union for validation result: 要么成功使用输入数据, or 失败使用错误消息.

    代码
    type Result<T> =
      | { ok: true; value: T }
      | { ok: false; errors: string[] };

    预期结果

    Result 类型那个 represents 要么成功 or 失败.

  2. 2

    编写 Schema validator

    创建简单 Schema validator 那个检查每个字段's 类型. Schema 映射字段 names 到 expected 类型字符串.

    代码
    function validate<T extends Record<string, unknown>>(
      schema: Record<keyof T, "string" | "number" | "boolean">,
      data: unknown
    ): Result<T> {
      if (typeof data !== "object" || data === null)
        return { ok: false, errors: ["Not an object"] };
      const obj = data as Record<string, unknown>;
      const errors: string[] = [];
      for (const key in schema) {
        if (typeof obj[key] !== schema[key])
          errors.push(`${key}: expected ${schema[key]}`);
      }
      return errors.length ? { ok: false, errors } : { ok: true, value: obj as T };
    }

    预期结果

    validator 那个检查数据针对 Schema and 返回输入 Result.

  3. 3

    Use validator

    定义 Schema and 验证 unknown 数据. On 成功, 值是 输入 as T, 启用 safe 属性 access.

    代码
    const result = validate<{ name: string; age: number }>(
      { name: "string", age: "number" },
      JSON.parse('{"name":"Alice","age":30}')
    );
    if (result.ok) console.log(result.value.name); // type-safe
    else console.log(result.errors);

    预期结果

    有效数据返回输入对象; 无效数据返回错误消息.

  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。

自己动手试试

你学到了什么

你构建运行时 validator 那个 produces 编译-时间输入 results. 这个 bridges gap 之间 untrusted 运行时数据 (JSON, 用户输入) and TypeScript's 静态类型系统 — 核心 challenge 的类型-safe 数据 handling.

查阅不认识的术语

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

查看术语表

解读错误信息

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

查看错误

← 返回主题