输入表单处理函数
你将构建什么
FormHandler 类那个 takes 字段定义对象, produces 输入 getters/setters for 每个字段, and 运行 validators 使用输入错误消息.
学习目标
- Use mapped 类型到 derive 表单值 类型
- 类型表单字段定义 and validators
- 构建 reactive 表单状态系统
- Apply keyof and indexed access 类型 practically
前置要求
- Mapped 类型
- Utility 类型
- Generics
步骤
- 1
定义字段 and 表单类型
创建 FieldDef 接口 for individual 字段 and mapped 类型那个 derives 值类型从 字段定义记录.
代码interface FieldDef<T> { initial: T; validate?: (value: T) => string | null; } type FormValues<F> = { [K in keyof F]: F[K] extends FieldDef<infer T> ? T : never };预期结果
字段定义 and 表单值 类型是 定义 using conditional 类型 inference.
- 2
编写表单处理函数类
创建 generic FormHandler 那个存储值, 运行 validators, and provides 输入 access 到每个字段.
代码class FormHandler<F extends Record<string, FieldDef<any>>> { private values: FormValues<F>; private errors: Partial<Record<keyof F, string>> = {}; constructor(private defs: F) { this.values = Object.fromEntries( Object.entries(defs).map(([k, d]) => [k, d.initial]) ) as FormValues<F>; } get<K extends keyof F>(key: K): FormValues<F>[K] { return this.values[key]; } set<K extends keyof F>(key: K, value: FormValues<F>[K]): void { this.values[key] = value; const validate = this.defs[key].validate; this.errors[key] = validate ? validate(value) : undefined; } hasErrors(): boolean { return Object.values(this.errors).some(Boolean); } }预期结果
表单处理函数使用输入获取/设置方法 and automatic validation.
- 3
Use 表单处理函数
定义表单字段使用 validators and use 处理函数. 每个字段 access 是类型-safe.
代码const form = new FormHandler({ name: { initial: "", validate: v => v.length < 2 ? "Too short" : null }, age: { initial: 0, validate: v => v < 0 ? "Negative" : null }, }); form.set("name", "Alice"); // type-safe: must be string form.set("age", 30); // type-safe: must be number console.log(form.get("name")); // "Alice" console.log(form.hasErrors()); // false预期结果
fully 输入表单使用 validation. 错误值 类型是 编译错误.
- 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。
自己动手试试
你学到了什么
你构建类型-safe 表单系统 using mapped 类型 and conditional 类型 inference. 表单值 类型是 derived 从字段定义 — 添加字段 automatically 更新所有 related 类型. 这个模式 powers 库如 React Hook 表单 and Formik.
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。