差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| typescript:什么是promise [2026/10/27 10:09] – 创建 张叶安 | typescript:什么是promise [2026/10/27 10:29] (当前版本) – 修复 .then((user) 中的 (( 被解析为脚注导致末尾渲染错乱 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== Promise 是什么 ====== |
| + | |||
| + | **Promise 是 JavaScript 中表示「一个异步操作的最终结果」的对象。** 它把「将来才会拿到的值」包装成一个可以等待、可以链式处理的对象,让异步代码像同步代码一样从上往下书写,避免层层嵌套的回调地狱(callback hell)。 | ||
| + | |||
| + | 一句话:Promise 是**结果的占位符**——现在还没有值,但未来一定会以「成功」或「失败」两种方式之一给出答复,并且只答复一次。 | ||
| + | |||
| + | ===== 三种状态 ===== | ||
| + | |||
| + | ^ 状态 ^ 含义 ^ 如何进入 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | 两条铁律: | ||
| + | |||
| + | * **状态只能改变一次**。一旦从 '' | ||
| + | * **状态不可逆**。成功不会变失败,失败也不会变成功。 | ||
| + | |||
| + | ===== 创建一个 Promise ===== | ||
| + | |||
| + | '' | ||
| + | |||
| + | <code ts> | ||
| + | function delay(ms: number): Promise< | ||
| + | return new Promise< | ||
| + | setTimeout(() => resolve(), ms); | ||
| + | }); | ||
| + | } | ||
| + | |||
| + | function fetchUserName(id: | ||
| + | return new Promise((resolve, | ||
| + | setTimeout(() => { | ||
| + | if (id > 0) { | ||
| + | resolve(' | ||
| + | } else { | ||
| + | reject(new Error(' | ||
| + | } | ||
| + | }, 100); | ||
| + | }); | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | 平时更常见的做法是**直接返回别人给的 Promise**(例如 '' | ||
| + | |||
| + | ===== 消费结果:then / catch / finally ===== | ||
| + | |||
| + | * '' | ||
| + | * '' | ||
| + | * '' | ||
| + | |||
| + | <code ts> | ||
| + | fetchUserName(1) | ||
| + | .then((name) => console.log(' | ||
| + | .catch((err) => console.error(' | ||
| + | .finally(() => console.log(' | ||
| + | </ | ||
| + | |||
| + | ===== 链式调用:then 的返回值决定下一步 ===== | ||
| + | |||
| + | 这是 Promise 最关键的机制: | ||
| + | |||
| + | * 回调返回**普通值** → 下一个 '' | ||
| + | * 回调返回**另一个 Promise** → 会等它完成,再把结果传给下一个 '' | ||
| + | * 回调**抛出异常** → 跳过后续所有 '' | ||
| + | |||
| + | <code ts> | ||
| + | interface User { | ||
| + | id: number; | ||
| + | name: string; | ||
| + | } | ||
| + | |||
| + | function getUser(id: number): Promise< | ||
| + | return Promise.resolve({ id, name: ' | ||
| + | } | ||
| + | |||
| + | function getOrders(userId: | ||
| + | return Promise.resolve([' | ||
| + | } | ||
| + | |||
| + | getUser(1) | ||
| + | .then((user) => getOrders(user.id)) | ||
| + | .then((orders) => { | ||
| + | if (orders.length === 0) throw new Error(' | ||
| + | return orders[0]; | ||
| + | }) | ||
| + | .then((orderId) => console.log(' | ||
| + | .catch((err: | ||
| + | </ | ||
| + | |||
| + | **忘记 '' | ||
| + | |||
| + | ===== 静态方法对照 ===== | ||
| + | |||
| + | ^ 方法 ^ 作用 ^ 结果 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | <code ts> | ||
| + | // 并发执行,全部成功才继续;任一失败直接进 catch | ||
| + | const [user, orders] = await Promise.all([getUser(1), | ||
| + | |||
| + | // 允许部分失败,逐条检查结果 | ||
| + | const results = await Promise.allSettled([getUser(1), | ||
| + | |||
| + | // 超时控制:让「超时」与「真实请求」赛跑 | ||
| + | function withTimeout< | ||
| + | const timeout = new Promise< | ||
| + | setTimeout(() => reject(new Error(' | ||
| + | ); | ||
| + | return Promise.race([task, | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | 注意 '' | ||
| + | |||
| + | ===== 和 async / await 的关系 ===== | ||
| + | |||
| + | '' | ||
| + | |||
| + | * '' | ||
| + | * '' | ||
| + | * 因此用 '' | ||
| + | |||
| + | <code ts> | ||
| + | async function loadOrderId(id: | ||
| + | try { | ||
| + | const user = await getUser(id); | ||
| + | const orders = await getOrders(user.id); | ||
| + | return orders[0] ?? null; | ||
| + | } catch (err) { | ||
| + | console.error((err as Error).message); | ||
| + | return null; | ||
| + | } | ||
| + | } | ||
| + | |||
| + | // 无依赖关系的任务应该并发,而不是串行 await | ||
| + | async function loadBoth(id: | ||
| + | const [user, orders] = await Promise.all([getUser(id), | ||
| + | return { user, orders }; | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | ===== TypeScript 中的类型 ===== | ||
| + | |||
| + | '' | ||
| + | |||
| + | <code ts> | ||
| + | const p: Promise< | ||
| + | |||
| + | // 可调用的 Promise:类型是函数,返回值是 Promise | ||
| + | type AsyncHandler = () => Promise< | ||
| + | |||
| + | // 注意不要写成 Promise< | ||
| + | async function ok(): Promise< | ||
| + | return ' | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | ===== 常见坑 ===== | ||
| + | |||
| + | * **忘了 return**:链不等待,后续拿到 '' | ||
| + | * **在 '' | ||
| + | * **未处理的 rejection**:没有 '' | ||
| + | * **多余的 new Promise 包装**:已有 Promise 时直接 '' | ||
| + | * **在 '' | ||
| + | * **把串行当并发**:连续 '' | ||
| + | |||
| + | ===== 一句话小结 ===== | ||
| + | |||
| + | Promise = **异步结果的状态容器 + 可链式传递的错误通道**。记住三点:**状态只变一次**、**then 的返回值决定下一步**、**失败沿链传播直到被 catch**。 | ||
| + | |||
| + | ===== 思维导图 ===== | ||
| + | |||
| + | ```mdk height=520 color=# | ||
| + | # Promise | ||
| + | ## 是什么 | ||
| + | - 异步结果的占位符 | ||
| + | - 解决回调地狱 | ||
| + | - 状态只能改变一次 | ||
| + | ## 三种状态 | ||
| + | - pending 待定 | ||
| + | - fulfilled 已兑现 | ||
| + | - rejected 已拒绝 | ||
| + | ## 创建 | ||
| + | - new Promise(executor) | ||
| + | - 执行器同步执行 | ||
| + | - resolve / reject | ||
| + | ## 消费 | ||
| + | - then 处理成功 | ||
| + | - catch 处理失败 | ||
| + | - finally 收尾清理 | ||
| + | ## 链式调用 | ||
| + | - 返回普通值继续传 | ||
| + | - 返回 Promise 自动等待 | ||
| + | - 抛异常跳到 catch | ||
| + | - 忘记 return 拿到 undefined | ||
| + | ## 静态方法 | ||
| + | - all 全部成功 | ||
| + | - allSettled 等全部结束 | ||
| + | - race 第一个结束 | ||
| + | - any 第一个成功 | ||
| + | ## async await | ||
| + | - async 必返回 Promise | ||
| + | - await 等待落定 | ||
| + | - 错误用 try catch | ||
| + | - 无依赖改用 Promise.all | ||
| + | ## 常见坑 | ||
| + | - forEach 里写 async | ||
| + | - 未处理 rejection | ||
| + | - 串行当并发 | ||
| + | ``` | ||