resolve 和 reject 是 Promise 构造函数中仅在执行器内有效的预置参数,只能调用一次以锁定状态;resolve(value) 触发 fulfilled 状态并传递值,reject(reason) 触发 rejected 状态并推荐传 Error 实例。

在 Promise 构造函数中,resolve 和 reject 是两个预置的函数参数,用于控制 Promise 的最终状态:成功(fulfilled)或失败(rejected)。它们**只能被调用一次**,且**仅在构造函数执行体内部有效**;调用后 Promise 状态即锁定,后续再调用无效。
resolve 与 reject 的作用和触发时机
resolve(value) 表示异步操作成功完成,Promise 进入 fulfilled 状态,并将 value 作为结果传递给后续 .then() 的第一个回调函数。
reject(reason) 表示操作失败,Promise 进入 rejected 状态,并将 reason(通常是 Error 实例)传递给 .catch() 或 .then(null, onRejected)。
正确使用的关键规则
- 只在 Promise 构造函数的执行器(executor)函数内调用:它们是 Promise 内部传入的参数,不能在外部定义或手动创建
- 避免多次调用:即使 resolve 和 reject 都被写入代码,只要其中一个先执行,另一个就失效(例如 try/catch 中同时写了两者,但 catch 里又调用了 resolve —— 这属于逻辑错误)
-
推荐用 Error 实例 reject:便于调试和堆栈追踪,如
reject(new Error('网络请求超时')),而非字符串或普通对象 - 不要遗漏错误处理分支:尤其在回调、事件监听或定时器中,确保所有异常路径都有明确的 reject
常见错误写法及修正示例
❌ 错误:在异步回调外提前 resolve/reject,或未包裹 try/catch 导致未捕获异常
Node.js 可靠编程技能。避免事件循环阻塞、异步陷阱、ESM 兼容问题和内存泄漏。触发词:Node.js 开发、async/await、流处理、性能优化、安全编码。
new Promise((resolve, reject) => {
setTimeout(() => {
// 没有处理可能抛错的操作
JSON.parse(invalidJson); // 抛出 SyntaxError,但没被 catch,Promise 永远不会 reject
resolve(data);
}, 100);
});
✅ 正确:在异步回调内统一处理成功与失败,用 try/catch 捕获同步异常
new Promise((resolve, reject) => {
setTimeout(() => {
try {
const data = JSON.parse(validJson);
resolve(data);
} catch (err) {
reject(new Error(`解析失败: ${err.message}`));
}
}, 100);
});
进阶提示:何时该用 resolve(undefined) 或 resolve(Promise)
resolve(undefined) 等价于 resolve(),会把 Promise 变为 fulfilled 状态,值为 undefined,适用于“只需通知完成,无需传值”的场景。
resolve(anotherPromise) 会将当前 Promise 的状态和结果“链式委托”给 anotherPromise(即当前 Promise 等待它结束),这是实现 Promise 链式嵌套的基础机制,但需注意避免无意中造成循环等待。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










