Generic Utility 库
你将构建什么
utils.ts file 使用 four generic 函数那个工作使用任何类型虽然 preserving 类型 safety 通过类型参数.
学习目标
- 编写 generic 函数使用类型参数
- Use keyof and indexed access 类型
- Preserve 类型关系之间输入 and 输出
- 理解类型 inference 从函数实参
前置要求
- Generics 基础
- keyof 运算符
- 数组
步骤
- 1
编写 identity and 选取
identity 返回它的实参 unchanged. 选取 extracts 单个属性从 对象 using keyof for 类型 safety.
代码function identity<T>(value: T): T { return value; } function pick<T, K extends keyof T>(obj: T, key: K): T[K] { return obj[key]; }预期结果
Two generic 函数. 选取是 类型-safe: 选取({: 1}, '') 返回数字.
- 2
编写 groupBy and 唯一
groupBy partitions 数组通过键 函数. 唯一移除 duplicates. 两者都 use generics 到工作使用任何元素类型.
代码function groupBy<T, K extends string>(arr: T[], fn: (x: T) => K): Record<K, T[]> { return arr.reduce((acc, x) => { const key = fn(x); (acc[key] ||= []).push(x); return acc; }, {} as Record<K, T[]>); } function unique<T>(arr: T[]): T[] { return [...new Set(arr)]; }预期结果
Four generic utility 函数那个工作使用任何类型.
- 3
添加类型守卫与运行时检查
编写类型守卫函数(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 分支。
- 4
添加泛型工具函数
编写泛型工具函数(如 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。
- 5
编译检查与类型测试
运行 tsc --noEmit 确认无类型错误;使用 expectTypeOf 或 @ts-expect-error 注释做类型级测试。编译通过是 TypeScript 项目的验收标准。
代码// Run: npx tsc --noEmit // Type-level test with @ts-expect-error // @ts-expect-error — string is not a number const bad: number = "oops"; // Correct usage compiles cleanly const good: number = 42;预期结果
tsc --noEmit 无错误输出;@ts-expect-error 行确实报错(被抑制)。
自己动手试试
你学到了什么
你练习编写 generic 函数哪里类型参数 T flows 从输入到 输出, preserving 类型信息. keyof constraint on 选取 ensures 仅有效属性 names 能是 used.
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。