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 收窄错误类型并安全访问异常信息。
按自己的节奏,确认真正理解。