第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类型中非常实用。此为一劳永逸的类型安全解包方案。