TypeScript 怎么提取 Promise 的返回值类型？(Awaited)

Question

仓乃文 · Accepted Answer

封装异步函数后需要获取返回值类型，但 ReturnType 得到的是 Promise，还要手动解包。Awaited 工具类型递归展开 Promise，直接拿到内部值类型，处理嵌套 Promise 也不在话下。基本用法： ```typescript type Result = Awaited>; // string ``` 提取异步函数返回值： ```typescript async function fetchUser(id: string): Promise<{ name: string; age: number }> { return { name: "Tom", age: 18 }; } type User = Awaited>; // { name: string; age: number } ``` 递归展开嵌套 Promise： ```typescript type Nested = Awaited>>; // string[] ``` 配合泛型使用： ```typescript async function wrapPromise(promise: Promise): Promise<{ data: T; timestamp: number }> { const data = await promise; return { data, timestamp: Date.now() }; } type WrappedResult = Awaited>>>; // { data: Promise; timestamp: number } ``` 补充说明： - Awaited 是 TS 4.5+ 内置工具类型 - 递归展开所有层级的 Promise，直到遇到非 Promise 值 - async 函数的返回值类型自动被 Promise 包装，Awaited 解包它 - 对非 Promise 类型直接返回原类型：Awaited = string - 源码实现：T extends Promise ? Awaited : T