Skip to content

输入表单处理函数

中等 约 25 分钟

你将构建什么

FormHandler 类那个 takes 字段定义对象, produces 输入 getters/setters for 每个字段, and 运行 validators 使用输入错误消息.

学习目标

  • Use mapped 类型到 derive 表单值 类型
  • 类型表单字段定义 and validators
  • 构建 reactive 表单状态系统
  • Apply keyof and indexed access 类型 practically

前置要求

  • Mapped 类型
  • Utility 类型
  • Generics

步骤

  1. 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. 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. 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. 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。

自己动手试试

你学到了什么

你构建类型-safe 表单系统 using mapped 类型 and conditional 类型 inference. 表单值 类型是 derived 从字段定义 — 添加字段 automatically 更新所有 related 类型. 这个模式 powers 库如 React Hook 表单 and Formik.

查阅不认识的术语

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

查看术语表

解读错误信息

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

查看错误

← 返回主题