Promise 是 ES6 引入的内置对象,用于规范异步操作,具有 pending/fulfilled/rejected 三种不可逆状态;通过 new Promise() 创建,支持链式调用、值穿透及 Promise.all/race/resolve/reject 等静态方法。

Promise 是 JavaScript 中处理异步操作的一种标准方式,它代表一个尚未完成、但未来会完成(或失败)的操作的结果。 它不是语法糖,也不是新语言特性,而是 ES6 正式引入的内置对象,用来更清晰、可靠地管理回调函数嵌套(即“回调地狱”)的问题。
Promise 的三种状态
每个 Promise 实例始终处于以下三种状态之一:
- pending(待定):初始状态,既没成功也没失败
-
fulfilled(已成功):操作成功完成,可调用
.then()获取结果 -
rejected(已失败):操作出错,可调用
.catch()捕获错误
状态一旦改变(pending → fulfilled 或 pending → rejected),就不可逆,也不会再变。
如何创建和使用 Promise
用 new Promise() 构造函数创建,它接收一个执行器函数(executor),该函数立即执行,并传入两个参数:resolve 和 reject —— 它们是预定义的函数,分别用来把 Promise 变成成功或失败状态。
立即学习“Java免费学习笔记(深入)”;
例如,模拟一个 1 秒后返回用户数据的异步请求:
const fetchUser = new Promise((resolve, reject) => {
setTimeout(() => {
const success = Math.random() > 0.2; // 80% 概率成功
if (success) {
resolve({ id: 123, name: "张三" });
} else {
reject(new Error("网络请求失败"));
}
}, 1000);
});
fetchUser
.then(user => console.log("获取成功:", user))
.catch(err => console.error("出错了:", err.message));
链式调用与值穿透
Promise 的最大优势之一是支持链式调用。每个 .then() 或 .catch() 都会返回一个新的 Promise,所以可以连续写多个 .then(),前一个的返回值会自动传给下一个。
- 如果
.then()回调返回一个普通值(如字符串、数字),下一个.then()会接收到它 - 如果返回的是另一个 Promise,下一个
.then()会等待它完成后再执行 -
.catch()能捕获前面所有环节抛出的错误(包括throw和 Promise rejection)
比如:先获取用户,再根据 ID 请求订单,最后打印总数:
fetchUser
.then(user => fetch(`/api/orders?userId=${user.id}`))
.then(res => res.json())
.then(orders => console.log("订单数:", orders.length))
.catch(err => console.error("任一环节失败:", err));
常用静态方法:Promise.all、Promise.race、Promise.resolve/reject
除了实例方法,Promise 还提供几个实用的静态方法:
-
Promise.all([p1, p2, p3]):全部成功才成功,任意一个失败就立刻 reject(适合并行请求且都必须成功) -
Promise.race([p1, p2, p3]):哪个先完成(无论成功/失败),就以它的结果为准(可用于超时控制) -
Promise.resolve(value):快速创建一个立即成功的 Promise(等价于new Promise(r => r(value))) -
Promise.reject(error):快速创建一个立即失败的 Promise
例如用 Promise.race 实现超时:
const timeout = ms => new Promise((_, reject) =>
setTimeout(() => reject(new Error("请求超时")), ms)
);
Promise.race([
fetch('/api/data'),
timeout(3000)
]).then(res => res.json()).catch(err => console.error(err));
基本上就这些。Promise 不复杂但容易忽略细节,关键是理解“状态不可逆”和“链式返回新 Promise”这两个核心机制。现代开发中,它常和 async/await 一起用,后者只是 Promise 的语法糖,底层完全一致。











