JavaScript / TypeScript / 系统课时

异步函数类型

异步函数类型

本课解决异步函数返回类型不明确的问题。你将掌握 Promise、async 函数和异步回调的类型写法,理解异步结果如何传递,并能在调用端正确处理成功值与异常。

学习目标

  • 为异步函数声明 Promise<T> 返回类型
  • 描述接收异步回调的函数签名
  • 正确处理异步结果和异常

async 函数的返回类型

async 函数的返回值会自动包装为 Promise。即使函数体直接返回字符串,完整返回类型仍然是 Promise<string>;没有返回值时应使用 Promise<void>。

ts
async function loadName(id: number): Promise<string> {
  return "user-" + id;
}

loadName(1001).then((name) => {
  console.log(name);
});

预期输出

text
user-1001

声明返回类型可以让调用方明确知道需要等待异步结果,也能在修改实现时及时发现类型错误。

使用 await 获取 Promise 结果

await 用于等待 Promise<T> 完成,并得到类型为 T 的结果。它不会跳过类型检查,只改变异步代码的书写方式。

ts
async function getPrice(): Promise<number> {
  return 99;
}

async function printPrice(): Promise<void> {
  const price = await getPrice();
  console.log(price + 1);
}

printPrice();

预期输出

text
100

这里 price 会被推断为 number。如果 getPrice 修改为返回其他类型,TypeScript 会提示不匹配的位置。

声明异步回调类型

接收异步任务的函数需要把回调返回值写成 Promise<T>。使用泛型可以让任务结果类型从回调传递到外层调用。

ts
type AsyncTask<T> = () => Promise<T>;

async function runTask<T>(task: AsyncTask<T>): Promise<T> {
  return await task();
}

runTask(async () => {
  return "完成";
}).then((result) => {
  console.log(result);
});

预期输出

text
完成

T 表示异步任务最终产生的数据类型,调用者不需要使用类型断言强行转换结果。

处理异步失败结果

异步函数抛出的异常会转换为拒绝状态的 Promise。TypeScript 不会自动记录所有可能异常,因此调用方仍需要根据业务场景捕获并判断。

ts
async function requestData(ok: boolean): Promise<string> {
  if (!ok) {
    throw new Error("请求失败");
  }
  return "数据";
}

requestData(false).catch((error: unknown) => {
  if (error instanceof Error) {
    console.log(error.message);
  }
});

预期输出

text
请求失败

使用 unknown 接收异常比直接声明 Error 更安全,因为不同来源的异步错误可能不是同一种对象。判断类型后再读取属性,可以避免运行时错误。

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

目录与阅读设置

阅读设置

17

记录一个想法

异步函数类型

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

登录哪都通