前言:
定期复盘---今天我们来复习一下 Promise 的几个方法,分别是:Promise.resolve、Promise.reject、Promise.then、Promise.catch、Promise.finally、Promise.all、Promise.allSettled、Promise.race、Promise.any;
接下来我们一起去看看吧,从深处去了解他们有什么区别!!!
目录
[Promise 状态](#Promise 状态)
[1. Promise.resolve](#1. Promise.resolve)
[2. Promise.reject](#2. Promise.reject)
[3. Promise.then](#3. Promise.then)
[① 函调函数异步执行](#① 函调函数异步执行)
[② 返回值](#② 返回值)
[③ promise穿透](#③ promise穿透)
[4. Promise.catch](#4. Promise.catch)
[① 语法糖的本质](#① 语法糖的本质)
[② 只有一个主人](#② 只有一个主人)
[5. Promise.finally](#5. Promise.finally)
[6. Promise.all](#6. Promise.all)
[7. Promise.allSettled](#7. Promise.allSettled)
[8. Promise.race](#8. Promise.race)
[9. Promise.any](#9. Promise.any)
Promise 状态
- 初始状态 -> pending
- 初始状态可以改变
- 在resolve 或者 reject 调用之前都处于这个状态
- 最终成功状态 -> fulfilled
- 执行 resolve 函数,状态改变为 fulfilled
- 执行 onFulfilled 函数
- 最终失败状态 -> rejected
- 执行 reject 函数,状态改变为 rejected
- 执行 onRejected 函数
- then 方法
- then 方法为 Promise 对象注册了 onFulfilled 和 onRejected 函数
- catch 方法
- catch 方法为Promise 对象注册了 onRejected 函数
1. Promise.resolve
静态方法 Promise.resolve(value)可以认为是 new Promise方法的语法糖,比如Promise.resolve(42) 可以认为是以下代码的语法糖。
javascript
new Promise(function (resolve) {
resolve(42)
})
这个静态方法会让Promise对象立即进入确定(即resolved) 状态,并将42传递给后面 then 里所指定的 onFulfilled函数。作为 new Promise的快捷方式,在进行 Promise 对象的初始化或者编写测试代码的时候都非常方便。
简单总结一下 Promise.resolve方法的话,它的作用就是将传递给它的参数填充 Fulfilled 到 Promise 对象后并返回这个 Promise 对象。
2. Promise.reject
Promise.reject(error)是和Promise.resolve(value)类似的静态方法,是 new Promise 方法的快捷方式。比如 Promise.reject(new Error("Promise reject error")) 就是下面代码的语法糖形式
javascript
new Promise(function (reject) {
reject(new Error("Promise reject error"))
})
简单总结一下 Promise.reject方法的话:它的功能是调用该 Promise对象通过then指定的 onRejected函数,并讲错误(Error)对象传递给这个onRejected函数
3. Promise.then
Promise.then(onFulfilled, onRejected)
① 函调函数异步执行
javascript
var promise = new Promise((resolve, reject) => {
console.log("inner Promise"); // 1
setTimeout(() => {
resolve("Fashion Barry"); // 3
}, 1000);
});
promise.then((res) => {
console.log("res", res);
});
console.log("outer promise"); // 2
// Promise 实际是一个同步函数,then 方法才是异步
// 所以输出顺序如上
Promise/A+规范统一规定:Promise 只能使用异步调用方式
② 返回值
不管你在回调函数 onFulfilled中会返回一个什么样的值,或者不返回值,该值都会由 Promis.resolve(return 的返回值) 进行响应的包装处理。因此,最终 then的结果都是返回一个新创建的 Promise对象。
也就是说,Promis.then不仅仅是注册一个回调函数那么简单,它还会将回调函数的返回值进行变换,创建并返回一个Promise 对象。正是 then函数中有了这样返回值的机制,才能使得在整个Promise链式结构当中,每个then方法都能给 下一个then方法传递参数。现在我们知道怎么返回的Promise是之前的还是新的?另外该Promise的状态又是如何?
javascript
var aPromise = new Promise((resolve, reject) => {
resolve("aPromise");
});
var thenPromise = aPromise.then((res) => {
console.log("thenPromise: ", res);
});
var catchPromise = aPromise.catch((err) => {
console.error("catchPromise: ", err);
});
console.log(aPromise !== thenPromise); // true
console.log(thenPromise !== catchPromise); // true
console.log(aPromise, thenPromise, catchPromise); // Promise { "aPromise" }, Promise { <pending> }, Promise { <pending> }
从上面结果来看,实际上不管是调用 then还是catch方法, 都返回了一个新的Promise对象
③ promise穿透
我们先来举个例子:
javascript
Promise.resolve("Barry")
.then(Promise.resolve("Barry Promise"))
.then((result) => {
console.log("result", result); // "Barry"
});
如果你认为输出的是【 Barry Promise 】,那么你就错了,实际上他输出的是 【 Barry 】
产生这么的输出是因为你给then方法传递了一个非函数(比如promise对象)的值,代码会这样理解 : then(null),因此导致了前一个promise的结果产生了坠落的效果,也就是和下面代码是一样的, 代码直接穿透了then(null)进入了下一层链:
javascript
Promise.resolve("Barry")
.then(null)
.then((result) => {
console.log("result", result); // "Barry"
});
随意添加多个then(null)结果都是一样的
javascript
Promise.resolve("Barry")
.then(null)
.then({ name: "My name is Barry" })
.then(null)
.then((result) => {
console.log("result", result); // "Barry"
});
4. Promise.catch
① 语法糖的本质
这里我们再说一遍,实际上Promise.catch只是promise.then(undefined, onRejected) 方法的一个别名而已。也就是说,这个方法用来注册当Promise对象状态变为 Rejected时 的回调函数。可以看下面代码,两者写法是等价的,但是很明显 Promise.catch会让人第一眼看上去不会眼花缭乱:
javascript
// 第一种写法
Promise.resolve()
.then((data) => console.log(data))
.then(undefined, (err) => console.log(err));
// 第二种写法
Promise.resolve()
.then((data) => console.log(data))
.catch((err) => console.log(err));
那么我们现在来说说为什么推荐使用第二种方法,而不是第一种:
- 使用promise.then(onFulfilled, onRejected) 的话,在onFulfilled中发生异常的话,onRejected 中是捕获不到这个异常的。而且如果链式很长,每一条链上都要这么写。
- 在promise.then(onFulfilled).catch(onRejected) 的情况下.then中产生异常能在.catch 中捕获。.then和.catch本质上是没有区别的, 需要分场合使用
② 只有一个主人
我们上面已经说过了,在书写很长的Promise链式,从代码清晰度和简易程度来讲,在最后添加 catch是远远在每一层链上写onRejected回调函数是要好的,因为catch可以捕获 Promise链中每一层节点的错误,这句话本身没有错,但从这句话延伸出一种错误的理解:catch 同时监控着所有节点。实际上catch函数在同一个时间点只属于某一个Promise,因为它的主人是随着程序 的执行而不断变化的,我们来举个例子:
javascript
let p1 = new Promise((resolve, reject) => {
// 第一层执行逻辑
resolve("first promise"); // Promise(1)
})
.then((res) => {
// 第二层执行逻辑
return "second promise"; // Promise(2)
})
.then((res) => {
// 第三层执行逻辑
return "third promise"; // Promise(3)
})
.catch((err) => {
console.log("err", err);
});
在上述例子中,如果整个程序每一步都正确执行,那么会顺序产生三个Promise对象,分别是 Promise(1),Promise(2),Promise(3):
- 可是如果在第一层具体执行逻辑出错了后,那实际上后面的两个then 中的回调函数压根不会被异步执行,所以会直接异步触发
catch
中的回调函数执行, 所以这种情况下catch是Promise(1)对象的catch。 - 如果第一层具体执行逻辑正确执行,就会异步触发第二个then中的回调函数执行,那么同理 ,在第二次具体执行逻辑抛出错误,会导致Promise(2)的状态变化,所以这种情况下catch 是Promise(2)对象的catch。
- 同理Promise(3)也是如此
总结下来就是:整个Promise链中,catch只属于异步触发它当中回调函数 执行的那个Promise,并不属于所有 Promise
5. Promise.finally
promise.finally方法的回调函数不接受任何参数,这意味着finally没有办法 知道,前面的Promise状态到底是fulfilled还是rejected 。这表明,finally方法里面的操作,应该是与Promise状态无关的,不依赖于 Promise的执行结果。我们来看下面代码:
javascript
var p1 = new Promise((resolve, rejevt) => {
setTimeout(() => {
resolve;
}, 1000);
});
p1.then((res) => console.log(res))
.catch((err) => console.log(err))
.finally(() => console.log("finally"));
finally本质上是then方法的特例。我们来看下面伪代码:
javascript
promise.finally(() => {
// 执行逻辑
});
// 上面代码等同于下面
promise.then(
(onFulilled) => {
// 语句
return onFulilled;
},
(onRejected) => {
// 语句
throw onRejected;
}
);
上面代码中,如果不使用finally方法,同样的语句需要为成功和失败的状态各写一次。 有了finally方法,则只需要写一次。那么它是如何实现的呢?
javascript
Promise.prototype.finally = function (callback) {
let p = this.constructor;
return this.then(
(value) => p.resolve(callback()).then(() => value),
(reason) =>
p.reject(callback()).then(() => {
throw reason;
})
);
};
var p = new Promise((resoleve, reject) => {
setTimeout(() => {
reject("Promise err");
}, 1000);
});
p.catch((err) => console.log("err", err)).finally(() => {
console.log("finally");
});
上述代码中,不管前面的Promise是fulfilled还是rejected ,都会执行回调函数callback
6. Promise.all
Promise.all接受一个promise对象的数组作为参数,当这个数组里的所有 Promise 对象 全部变为resolve或者reject状态的时候,它才会去调用.then方法。
传递给Promise.all的 promise并不是一个个的顺序执行的,而是同时开始、并行执行的,我们可以看下面例子
javascript
var promise1 = new Promise((resoleve, reject) => {
setTimeout(() => {
resoleve("promise1--3000");
}, 3000);
});
var promise2 = new Promise((resoleve, reject) => {
setTimeout(() => {
resoleve("promise2--1000");
}, 1000);
});
var promise3 = new Promise((resoleve, reject) => {
setTimeout(() => {
resoleve("promise3--5000");
}, 5000);
});
var promiseArr = [promise1, promise2, promise3];
console.time("promiseArr");
Promise.all(promiseArr)
.then((res) => {
console.log("res", res); // ['promise1--3000', 'promise1--1000', 'promise1--5000']
console.timeEnd("promiseArr"); // 5523.29296875 ms
})
.catch((err) => console.log(err));
为什么这个例子可以看出来Promise.all()是并行的呢?因为所有Promise执行完只用了5秒,如果3个 Promise是按照顺序执行的,那么应该是9秒或者,在5-9之间,因为4个Promise并不是同时执行的,同时执行的 话总时间就是那个花费时间最长的Promise
Promise.all()重要细节点 (面试常考):
- 如果所有的Promise中只有一个执行错误,那么整个Promise.all不会走Promise.all().then() 而是走Promise.all().catch()这个流程了。但是要注意的是虽然走到了Promise.all().catch()这个流程 ,但是其他 Promise 还是会正常执行,但不会返回结果
- 要注意Promise.all()的返回值顺序,Promise.all().then()的返回值顺序和传入的顺序是一致的,笔试时 遇到手写Promise.all()时要注意。
7. Promise.allSettled
Promise.allSettled()的入参和Promise.all、Promise.race一样,接受一个promise 对象的数组作为参数,也是同时开始、并行执行的。但是Promise.allSettled的返回值需要注意以下几点:
Promise.allSettled不会走进catch,当所有输入Promise都被履行或者拒绝时,
statusesPromise 会解析一个具有具体完成状态的数组
- { status: 'fulfilled', value:value }
- { status: 'rejected', reason: reason }:如果相应的promise被拒绝
我们看下面示例:
javascript
var promise1 = new Promise((resoleve, reject) => {
setTimeout(() => {
reject(new Error("promise1--3000"));
// resoleve("promise1--3000");
}, 3000);
});
var promise2 = new Promise((resoleve, reject) => {
setTimeout(() => {
// reject(new Error("promise1--1000"))
resoleve("promise2--1000");
}, 1000);
});
var promise3 = new Promise((resoleve, reject) => {
setTimeout(() => {
resoleve("promise3--5000");
// reject(new Error("promise1--5000"))
}, 5000);
});
var promiseArr = [promise1, promise2, promise3];
console.time("promiseArr");
Promise.allSettled(promiseArr)
.then((res) => {
console.log("res", res);
console.timeEnd("promiseArr");
})
.catch((err) => console.error(err))
.finally(() => console.log("finally"));
总结一下:Promise.allSettled()在你需要执行平行和独立的异步操作并收集所有结果时非常有效, 即使某些异步操作可能失败。
8. Promise.race
Promise.rece()的使用方法和 Promise.all一样,接收一个promise 对象的数组为参数,Promise.race是要有一个promise对象进入Fulfilled或者 Rejected状态的话,就会继续进行后面的处理。这里依旧有两个点要注意:
- 和Promise.all一样是所有数组当中的Promise同时并行的
- Promise.race 在第一个Promise对象变为Fulfilled之后,并不会 取消其他promise对象的执行。
- Promise.race接受的是一个Promise对象数组,但是返回的确实最先完成Fulfilled 或者最先被Rejected的一个Promise的结果
下面我们来举个例子:
javascript
let arr = [1000, 3000, 5000, 7000];
let promiseArr = [];
for (let i = 0; i < arr.length; i++) {
let newPromise = new Promise((resolve, reject) => {
if (i === 0) {
reject(new Error("第二个错误"));
} else {
setTimeout(() => {
console.log(arr[i]);
resolve(arr[i]);
}, arr[i]);
}
});
promiseArr.push(newPromise);
}
Promise.race(promiseArr)
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
});
// 控制台报错
// 3000
// 5000
// 7000
这里我们再复习一下Node当中事件循环的知识:
- 第一层循环:i为0时,异步触发了Promise.race().catch(),这里面的回调代码被放在了微任务队列中, 后面的3个setTimeout宏任务的回调函数代码被放进了timer阶段中的队列当中(其实并不是这样,因为 三个定时器都有延迟,都是在后面的事件循环中添加进来的)
- 第二层循环:清空微任务对列,所以控制台打印出了错误,然后清空宏任务,分别打印出3000/5000/7000
9. Promise.any
Promise.any的入参和Promise.all、Promise.race、Promise.allSettled一样, 接收一个promise对象的数组作为参数。
- 只要其中有一个Promise成功执行,就会返回已经成功执行的Promise的结果
- 如果这个promise对象的数组中没有一个promise 可以成功执行(即所有的 promise都失败 ),就返回一个失败的promise 和AggregateError类型的实例,它是Error的一个子类,用于把单一的错误集合 在一起
javascript
var promise1 = new Promise((resoleve, reject) => {
setTimeout(() => {
// reject(new Error("promise1--3000"));
resoleve("promise1--3000");
}, 3000);
});
var promise2 = new Promise((resoleve, reject) => {
setTimeout(() => {
// reject(new Error("promise2--1000"))
resoleve("promise1--1000");
}, 1000);
});
var promise3 = new Promise((resoleve, reject) => {
setTimeout(() => {
// resoleve("promise3--5000");
reject(new Error("promise1--5000"))
}, 5000);
});
var promiseArr = [promise1, promise2, promise3];
console.time("promiseArr");
Promise.any(promiseArr)
.then((res) => {
console.log("res", res); // res promise1--1000
console.timeEnd("promiseArr");
})
.catch((err) => console.error(err));
//所有的Promise都失败, AggregateError: All promises were rejected
总计一下Promisea.any的应用场景:如果我们现在有多台服务器,则尽量使用响应速度最快的服务器,在这种情况下, 可以使用Promise.any()方法从最快的服务器接收响应。