类型 Guard Toolkit
你将构建什么
设置的 类型 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
编写 primitive 类型 guards
创建类型 guards for primitives using typeof. 返回类型
x 是 Ttells 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
编写对象 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
构建组合 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
添加类型守卫与运行时检查
编写类型守卫函数(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。
自己动手试试
你学到了什么
你构建 reusable 类型 guards 那个 narrow 类型 at 运行时. x 是 T predicate 是键 — 它 bridges 运行时检查到 编译-时间类型 safety, 启用 TypeScript 到 narrow 类型内部如果块 automatically.
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。