为何Promise.allSettled返回Promise<PromiseSettledResult<Awaited<T>>[]>类型？

当你传入类型为Promise<T>的变量x到Promise.allSettled([x])时，实际返回类型是Promise<PromiseSettledResult<Awaited<T>>>而非预期的Promise<PromiseSettledResult<T>>，核心原因是TypeScript的类型定义要匹配运行时的实际行为，同时兼容更复杂的嵌套Promise场景。

1. 类型定义的核心逻辑 #

TypeScript中Promise.allSettled的类型签名（简化后）为：

Promise.allSettled<T extends readonly unknown[] | []>(
  values: T
): Promise<{ -readonly [P in keyof T]: PromiseSettledResult<Awaited<T[P]>> }>;

这里的Awaited<T[P]>是关键——它的作用是递归解析Promise的最终值，能处理所有嵌套的Promise或thenable对象。

2. 匹配运行时的实际行为 #

运行时，Promise.allSettled会等待传入的所有Promise（包括嵌套的Promise）完全完成：

• 如果x是Promise<string>，运行时最终拿到的成功值是string，Awaited<Promise<string>>正好解析为string，类型和运行结果一致；
• 如果x是Promise<Promise<string>>，运行时会等待内层Promise完成，最终成功值还是string，而Awaited<Promise<Promise<string>>>也会递归解析为string，完美匹配实际结果。

如果不用Awaited<T>，当x是嵌套Promise时，类型会错误地显示为PromiseSettledResult<Promise<string>>，这和运行时拿到的实际值完全不符。

3. 兼容非Promise类型的传入 #

Promise.allSettled还支持直接传入非Promise值，比如字符串、数字等，此时Awaited<原始类型>就是类型本身，依然能正确反映最终结果：

const res = Promise.allSettled(["hello"]);
// res的类型是Promise<PromiseSettledResult<string>[]>

综上，Awaited<T>的存在是为了让类型系统准确反映Promise.allSettled运行时的真实行为，不管传入的是普通值、单层Promise还是嵌套Promise，类型都能正确解析到最终的完成值。

内容的提问来源于stack exchange，提问作者Simon Berens