Awaited 类型
一句话解释
Awaited<T> 解包嵌套 Promise——Awaited<Promise<Promise<number>>> 是 number。
用大白话说
Awaited<T> 工具类型(TypeScript 4.5+)递归解包 Promise 类型以获取最终解析值类型。这是 async/await 内部使用的。Awaited<Promise<number>> 是 number。 Awaited<Promise<Promise<string>>> 是 string(递归解包)。Awaited<number> 是 number(非 Promise 直接通过)。适用于:1. 提取异步函数返回类型——Awaited<ReturnType<typeof fetchData>>
- 处理 thenable 类型——处理自定义 Promise-like 对象
- 异步生成器中的类型推断——获取 yield 的值类型它是
async函数返回类型推断的基础。
示例
typescript
type T1 = Awaited<Promise<number>>; // number
type T2 = Awaited<Promise<Promise<string>>>; // string (recursive)
type T3 = Awaited<number | Promise<string>>; // number | string
type T4 = Awaited<boolean>; // boolean (non-promise passes through)
// Practical use: extract async function return type
async function fetchUser(): Promise<{ name: string; age: number }> {
return { name: "Alice", age: 30 };
}
type User = Awaited<ReturnType<typeof fetchUser>>; // { name: string; age: number }
// Without Awaited, ReturnType would be Promise<{ name: string; age: number }>Awaited 递归解包 Promise 到其解析类型。适用于从异步函数提取实际值类型。
常见混淆
容易混淆的对象: Promise 类型
关键区别: Promise<T> 是解析为 T 的 promise 的类型。Awaited<Promise<T>> 是 T——它解包 promise。Awaited 处理嵌套 promise 和联合类型,始终给你最终解析值类型。
相关术语
相关资源
相关课程
- TypeScript 工具类型
Awaited。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。