第95章 工具类型Awaited

案例95:用Awaited精准提取Promise返回类型

题目:在异步接口中,经常需要从嵌套的Promise类型中提取最终返回值。请利用TypeScript内置工具类型Awaited,实现一个从复杂嵌套异步函数中推断出真正返回类型的工具,并验证其正确性。

设计思路

定义一个模拟异步请求的函数fetchUserData,其返回类型是Promise<Promise<User>>(模拟双层异步包装)。使用Awaited工具类型提取最内层类型,并定义一个同步函数processUser接收该类型参数,在编译期确保类型匹配。

核心代码

interface User {
  id: number;
  name: string;
}

// 模拟嵌套异步:外层Promise包内层Promise
declare function fetchUserData(): Promise<Promise<User>>;

// 使用Awaited提取最终类型
type FinalUser = Awaited<ReturnType<typeof fetchUserData>>;

// 直接用Awaited声明变量
declare const user: Awaited<Promise<Promise<User>>>;

// 验证:传入正确类型
function processUser(u: FinalUser) {
  console.log(`用户: ${u.name} (ID: ${u.id})`);
}

// 运行时验证(类型已在编译期锁定)
const mockUser: User = { id: 1, name: '张三' };
processUser(mockUser);
processUser(user); // 此处user类型已被推断为User

运行验证

在tsconfig中设置"strict": true,运行npx tsc --noEmit确认无类型错误。若去掉Awaited而直接使用Promise<User>作为参数类型,会立即报类型不兼容错误,清晰展示工具类型的作用。

注意事项

1. Awaited在TypeScript 4.5+可用,且能递归展开所有层级的Promise,包括PromiseLike类型。
2. 不要与ReturnType混淆:ReturnType提取函数返回值的外层类型,而Awaited专门处理异步展开。

成功要点

掌握Awaited后可轻松处理复杂的异步类型推导,尤其在React的useEffect或状态管理中层叠的Promise类型中非常实用。此为一劳永逸的类型安全解包方案。