Promise 是 JavaScript 异步编程的标准化抽象层,本质是管理状态(pending/fulfilled/rejected)和终值的容器,不执行异步逻辑;new Promise() 立即执行 executor,then/catch 返回新 Promise,状态不可逆,错误需显式捕获或处理。

Promise 不是语法糖,而是 JavaScript 异步编程的标准化抽象层——它不解决“怎么写异步”,而是解决“怎么组合、传递、统一处理异步结果”。
Promise 是什么:一个有状态的容器,不是回调函数的封装
Promise 本质是一个对象,内部保存着一个异步操作的状态(pending / fulfilled / rejected)和最终值(或拒因)。它不执行异步逻辑,只管理状态流转和响应注册。
- 你传给
new Promise()的执行器函数(executor)会**立即同步执行**,但其中的异步操作(如setTimeout、fetch)才真正延迟触发状态变更 -
then()和catch()返回的是**新 Promise**,不是原对象,所以可链式调用但不可“复用”同一个 Promise 实例来多次获取结果 - 一旦状态变为
fulfilled或rejected,就不可逆,后续所有then()/catch()都只能读取该终值
如何创建并触发 Promise:用 new Promise() 包裹异步逻辑
最常见错误是把同步代码也塞进 Promise 构造器里,或者忘了调用 resolve() / reject()。
const fetchData = () => {
return new Promise((resolve, reject) => {
// ✅ 正确:异步操作在 executor 内启动
fetch('/api/data')
.then(res => {
if (!res.ok) throw new Error(`HTTP ${res.status}`);
return res.json();
})
.then(data => resolve(data))
.catch(err => reject(err));
// ❌ 错误:漏掉 reject,或在 fetch 外直接 resolve()
});
};- 务必确保
resolve()或reject()**至少被调用一次**,否则 Promise 永远卡在pending - 不要在 executor 中抛出未捕获错误(如
throw 'oops'),这会直接让 Promise 进入rejected状态,但堆栈信息可能丢失 - 若只是包装已有回调 API(如 Node.js 的
fs.readFile),优先用util.promisify()而非手写 Promise
如何安全地消费 Promise:避免 then() 链断裂和隐式异常
最常见的坑是以为 then(onFulfilled) 能捕获前面所有错误,其实它只捕获上一级 Promise 的 rejection,且自身抛错不会被同一级 catch() 捕获。
立即学习“Java免费学习笔记(深入)”;
promise
.then(data => {
console.log(data);
throw new Error('boom'); // ❌ 这个错误不会被下面的 catch 捕获(除非加 return)
})
.catch(err => console.error(err)); // 只捕获 promise 本身的 rejection- 每个
then()回调若返回值不是 Promise,会被自动包装成Promise.resolve(value);若抛错,则等价于返回Promise.reject(err) - 推荐写法:
.then(fn).catch(handleError)放在链末尾,而非每个then()后都跟catch() - 想“吞掉”错误并继续链式执行?显式返回
Promise.resolve()或默认值,例如:.catch(() => [])
Promise.all() / Promise.race() 的实际约束和替代方案
Promise.all() 并非“并发请求工具”,而是一个**全成功才 resolve,任一失败即 reject** 的协调器;Promise.race() 则只取第一个 settled 的结果,容易忽略超时或失败场景。
-
Promise.all([p1, p2, p3]):只要任意一个 Promise reject,整个就 reject,不会等其余完成。不适合“容错聚合” - 需要“全部执行完,不管成败”?用
Promise.allSettled()(ES2020+) - 需要“首个有效响应”但又不想被失败中断?得手动封装:
Promise.race([p1.catch(() => null), p2.catch(() => null)]) -
浏览器中做超时控制?别只靠
race(),要配合AbortController(如fetch(signal))才能真正中断请求
Promise 的复杂点不在创建,而在状态穿透与错误流向——尤其当嵌套 then()、混用 async/await、或与事件循环(如 setTimeout(0))交互时,终值何时可读、错误从哪冒出来,很容易偏离直觉。









