运行时数据 Validator
你将构建什么
验证函数那个 takes Schema 定义 and unknown 数据, 检查每个字段, and 返回要么输入对象 or 列表的 错误.
学习目标
- Bridge 运行时 validation 到编译-时间类型
- 构建 Schema 定义系统
- 返回输入成功 or 错误 results
- 练习 discriminated unions for results
前置要求
- 类型 guards
- Discriminated unions
- Conditional 类型
步骤
- 1
定义 result 类型
Use discriminated union for validation result: 要么成功使用输入数据, or 失败使用错误消息.
代码type Result<T> = | { ok: true; value: T } | { ok: false; errors: string[] };预期结果
Result 类型那个 represents 要么成功 or 失败.
- 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
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
添加类型守卫与运行时检查
编写类型守卫函数(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
添加泛型工具函数
编写泛型工具函数(如 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 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。