第100章 综合小应用

案例题目:待办事项的类型安全看板

本案例实现一个基于TypeScript类型系统的待办事项管理函数库,涵盖接口定义、枚举状态、泛型约束与异步更新操作,全程保证类型安全。

设计思路

定义Todo接口描述任务结构,使用枚举管理任务状态(待办/进行中/已完成)。通过泛型约束的过滤函数按状态筛选任务,最后提供异步的批量状态更新方法,模拟真实场景中的持久化操作。

核心代码

enum TaskStatus {
  Pending = "待办",
  Active = "进行中",
  Done = "已完成"
}

interface Todo {
  id: number;
  title: string;
  status: TaskStatus;
}

const todos: Todo[] = [
  { id: 1, title: "学习TS泛型", status: TaskStatus.Active },
  { id: 2, title: "编写实战案例", status: TaskStatus.Pending },
  { id: 3, title: "运行测试", status: TaskStatus.Done }
];

function filterByStatus<T extends Todo>(
  list: T[],
  status: TaskStatus
): T[] {
  return list.filter(item => item.status === status);
}

async function batchUpdateStatus(
  ids: number[],
  newStatus: TaskStatus
): Promise<number> {
  await new Promise(resolve => setTimeout(resolve, 100));
  ids.forEach(id => {
    const todo = todos.find(t => t.id === id);
    if (todo) todo.status = newStatus;
  });
  return ids.length;
}

// 使用示例
(async () => {
  console.log("进行中任务:", filterByStatus(todos, TaskStatus.Active));
  await batchUpdateStatus([2], TaskStatus.Active);
  console.log("更新后待办数:", filterByStatus(todos, TaskStatus.Pending).length);
})();

运行结果验证

运行后控制台应输出:
进行中任务: [{ id: 1, title: '学习TS泛型', status: '进行中' }]
更新后待办数: 0

测试建议

将filterByStatus传入空数组或无效状态验证边界,使用tsc --strict编译检查类型安全。

注意事项

枚举成员是只读的,不能直接修改。异步函数必须await后续操作,否则会导致状态未更新就读取。

成功要点

通过泛型约束保证函数复用性,利用枚举+接口实现业务状态封闭,异步处理模拟真实应用交互。