Skip to content

Generic 状态 Manager

中等 约 20 分钟

你将构建什么

存储<T> 类那个持有状态的 类型 T, notifies subscribers on 更改, and 仅接受 updater 函数那个返回类型 T.

学习目标

  • 创建 generic 状态容器
  • Enforce 不可变更新通过类型
  • 类型 subscription 回调
  • 构建 mini Redux-如模式

前置要求

  • Generics
  • 函数 as 类型
  • 不可变模式

步骤

  1. 1

    定义存储类

    创建 generic 存储<T> 那个持有状态 and 列表的 监听器. 状态是 仅 readable 从之外; 更新 go 通过 setter.

    代码
    class Store<T> {
      private state: T;
      private listeners: ((state: T) => void)[] = [];
      constructor(initial: T) { this.state = initial; }
      get(): T { return this.state; }
      set(updater: (prev: T) => T): void {
        this.state = updater(this.state);
        this.listeners.forEach(l => l(this.state));
      }
      subscribe(listener: (state: T) => void): () => void {
        this.listeners.push(listener);
        return () => { this.listeners = this.listeners.filter(l => l !== listener); };
      }
    }

    预期结果

    generic 存储类 使用输入获取, 设置, and subscribe 方法.

  2. 2

    Use 存储使用输入状态

    创建存储使用特定状态类型. 所有更新 and subscriptions 是现在类型-检查.

    代码
    interface CounterState { count: number; label: string; }
    const store = new Store<CounterState>({ count: 0, label: "visits" });
    store.subscribe(s => console.log(s.count));
    store.set(prev => ({ ...prev, count: prev.count + 1 }));

    预期结果

    状态更新是 类型-safe. Returning 错误 shape 是编译错误.

  3. 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. 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. 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 行确实报错(被抑制)。

自己动手试试

你学到了什么

你构建类型-safe 状态容器. updater 函数 (prev: T) => T enforces 那个更新返回相同 shape as current 状态, preventing 部分 or malformed 更新 at 编译时间.

查阅不认识的术语

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

查看术语表

解读错误信息

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

查看错误

← 返回主题