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 更安全,因为不同来源的异步错误可能不是同一种对象。判断类型后再读取属性,可以避免运行时错误。
按自己的节奏,确认真正理解。