JavaScript / TypeScript / 系统课时

声明 Promise 类型

声明 Promise 类型

本课解决 TypeScript 中异步结果类型不明确的问题。通过为 Promise 声明泛型参数,可以让异步函数返回值、链式调用和 await 后的数据保持准确类型提示。

学习目标

  • 掌握 Promise 泛型参数的声明方式。
  • 理解 async 函数与 Promise 返回类型的关系。
  • 使用 Awaited 提取异步结果的实际类型。

Promise 类型的基本声明

Promise 表示一个未来完成或失败的异步操作,它通过泛型参数描述成功状态下的结果类型。常见写法是 Promise<T>,其中 T 表示最终 resolve 的数据类型。

例如,一个返回用户信息的异步函数可以明确声明返回 Promise:

ts
interface User {
  id: number;
  name: string;
}

function fetchUser(): Promise<User> {
  return Promise.resolve({
    id: 1,
    name: "Alice"
  });
}

预期结果

text
fetchUser() 的返回类型为 Promise<User>
await fetchUser() 的结果类型为 User

声明类型后,调用方可以直接获得字段提示,避免通过 any 猜测异步返回结构。

async 函数中的返回类型

使用 async 声明的函数一定会返回 Promise。即使函数内部直接返回普通值,TypeScript 也会自动包装为 Promise 类型。

ts
async function getCount(): Promise<number> {
  return 10;
}

async function main() {
  const count = await getCount();
  console.log(count);
}

main();

预期结果

text
10

在团队开发中,推荐显式声明公开函数的 Promise 返回类型,这样接口变化时可以更早发现类型错误。

使用 Awaited 提取异步结果类型

Awaited<T> 用于获取 Promise 被 await 后得到的实际类型。它适合封装工具类型、定义接口返回值或处理多层 Promise。

ts
type ResponseType = Awaited<Promise<{ code: number; data: string }>>;

const response: ResponseType = {
  code: 200,
  data: "success"
};

预期结果

text
ResponseType 等价于 { code: number; data: string }

如果存在多层 Promise,Awaited 也会递归展开,直到获得最终结果类型。

常见边界与错误

声明 Promise 类型时,需要区分 Promise 本身和异步完成后的值。Promise<User> 表示异步对象,而 User 表示 await 后的数据。

错误示例:

ts
async function loadUser(): User {
  return {
    id: 1,
    name: "Alice"
  };
}

预期结果

text
类型错误:async 函数必须返回 Promise 类型

正确写法应该是 Promise<User>。

本课总结

  • Promise<T> 用于描述异步操作最终成功返回的数据类型。
  • async 函数始终返回 Promise,显式声明返回类型可以提高可维护性。
  • Awaited<T> 可以提取 Promise 完成后的真实结果类型。

下一课预告

下一课将介绍如何处理 TypeScript 中的未知异常,通过 unknown 收窄错误类型并安全访问异常信息。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

声明 Promise 类型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通