Skip to content

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>>

  1. 处理 thenable 类型——处理自定义 Promise-like 对象
  2. 异步生成器中的类型推断——获取 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 和联合类型,始终给你最终解析值类型。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表