promise是一个容器,保存着未来才会结束的时间的结果,它内部在执行异步操作,只是将异步操作后的结果返回出来,并通过统一的API返回异步操作的结果。
1:基本用法:
const promise = new Promise((resolve,reject)=>{
//异步操作的code
if( 异步操作成功 ){
resolve(value) //将内部的状态由pending更新为success,并将结果返回到外部 ,resolve函数的参数除了正常的值以外,还可能是另一个Promise实例。
} else {
reject(error) //将内部的状态由pengding更新为fail,并将结果返回到外部 ,reject()方法的作用,等同于抛出错误
}
})
以上仅仅是将结果返回出来,并且是根据内部的异步操作逻辑,在适当的场景下返回成功或失败的结果
实例再用then方法分别指定resolved状态和rejected状态的回调函数:回调函数都是可选
promise.then(
function(value){}, //接成功的返回结果
function(error){} //接失败的返回结果
)
考点来了:
Promise 新建后就会立即执行。
let promise = new Promise(function(resolve, reject) {
console.log('Promise'); //promise新建之后立即执行,所以会先输出Promise
resolve();});
promise.then(function() {
console.log('resolved.');}); //then方法指定的回调函数,将在当前脚本所有同步任务执行完才会执行,所以resolved最后输出
console.log('Hi!'); //同步任务
// Promise
// Hi!
// Resolved
调用resolve或reject并不会终结 Promise 的参数函数的执行,记住Promise的参数是一个函数,函数中,立即执行的resolve或reject都会在then中返回,但resolve或reject之后的同步任务还会继续执行,并且then方法中的处理都会晚于该参数函数中的同步任务。
但是,一般来说,调用resolve或reject以后,Promise 的使命就完成了,后继操作应该放到then方法里面,而不应该直接写在resolve或reject的后面。所以,最好在它们前面加上return语句,这样就不会有意外。
new Promise((resolve,reject)=>{
return resolve(1); // return之后的语句就不再执行了
console.log(2)
})
2:Promise.prototype.then
作用是为Promise实例添加状态改变时的回调函数。
第一个参数是resolved状态的回调函数,第二个参数是rejected状态的回调函数,都是可选函数。
then方法返回一个新的Promise实例(注意不是原来那个promise实例),因此可以采用链式写法,即then方法后面再调用另一个then方法。 第一个回调函数完成以后,会将返回结果作为参数,传入第二个回调函数。
采用链式的then,可以指定一组按照次序调用的回调函数。这时,前一个回调函数,有可能返回的还是一个Promise对象(即有异步操作),这时后一个回调函数,就会等待该Promise对象的状态发生变化,才会被调用。
3:Promise.prototype.catch
该方法是then(null,rejection)或then(undefined,rejection)的别名,用于执行发生错误时的回调函数。
new Promise((resolve,reject)=>{}).then((value)=>{}).catch((err)=>{})
catch方法捕获的promise中reject的结果,和then()方法中的运行时抛出的错误
如果 Promise 状态已经变成resolved,再抛出错误是无效的。 因为 Promise 的状态一旦改变,就永久保持该状态,不会再变了
Promise 对象的错误具有“冒泡”性质,会一直向后传递,直到被捕获为止。也就是说,错误总是会被下一个catch语句捕获。
如果没有使用catch()方法指定错误处理的回调函数,Promise 对象抛出的错误不会传递到外层代码,即不会有任何反应。catch时Promise这个容器像外部抛出错误的一个Api。如果不使用catch方法捕获错误,错误就会被Primose吃掉。
const promise = new Promise(function (resolve, reject) {
resolve('ok');
setTimeout(function () { throw new Error('test') }, 0)}); //在下一轮"事件循环"做的事情
promise.then(function (value) { console.log(value) });
// ok
// Uncaught Error: test
catch方法返回的还是一个Promise对象,因此后面还可以接着调用then方法。 如果没有报错,则会跳过catch()方法
4:Promose.prototype.finally
finally方法用于指定不管Promise对象最后状态如何,都会执行的操作。
promise.then().catch().finally(()=>{
//todo
})
finally方法的回调函数不接受任何参数,这意味着没有办法知道,前面的 Promise 状态到底是fulfilled还是rejected。这表明,finally方法里面的操作,应该是与状态无关的,不依赖于 Promise 的执行结果
promise
.finally(() => {
// 语句
});
// 等同于
promise
.then(
result => {
// 语句
return result;
},
error => {
// 语句
throw error;
});
上面代码中,如果不使用finally方法,同样的语句需要为成功和失败两种情况各写一次。有了finally方法,则只需要写一次。所以说finally是then方法的特例。
finally总是返回上层then方法的值。
5:Promise.all
用于将多个Promise实例,包装成一个新的Promise实例。
const p = Promise.all([p1,p2,p3]);
参数是数组,可以不是数组,但必须是具有Iterator接口,且返回的每个成员都是Promise实例。
数组的成员是Promise的实例,如果不是Promise的实例,会先调用下面的Promise.resolve方法,将参数转为Promise实例,再做处理,
p的状态由p1,p2,p3决定,分成两种情况。
1:只有p1,p2,p3的状态都变成fulfilled,p的状态才会变成fulfilled.此时p1,p2,p3的返回值组成一个数组,传递给p的回调函数。
2:只要p1,p2,p3之中有一个被rejected,p的状态就变成rejected,此时第一个被reject的实例的返回值,会传递给p的回调函数。
如果作为参数的 Promise 实例,自己定义了catch方法,那么它一旦被rejected,并不会触发Promise.all()的catch方法
如果p1,p2,p3没有自己的catch方法,就会调用Promise.all()的catch方法
6:Promise.race
将多个Promise实例包装成一个新的Promise实例。
const p = Promise.race([p1,p2,p3]);
只要p1,p2,p3之中有一个实例率先改变状态,p的状态就跟着改变,那个率先改变的Promise实例的返回值,就传递给p的回调函数。
Promise.race()方法的参数与Promise.all()方法一样,如果不是 Promise 实例,就会先调用下面讲到的Promise.resolve()方法,将参数转为 Promise 实例,再进一步处理。
如果指定时间内没有获得结果,就将 Promise 的状态变为reject,否则变为resolve。
7:Promise.allSettled
接收一组Promise实例作为参数,包装成一个新的Promise实例,只有等到所有这些参数实例都返回结果,不管是fulfilled还是rejected,包装实例才会结束。
该方法返回的新的Promise实例,一旦结束,状态总是fulfilled,不会变成rejected,状态变成fulfilled后,Promise的监听函数then方法中接收到的参数是一个数组,数组中的每个成员对应一个传入Promise.allSettled的Promise实例。数组中每个成员都是一个对象,对象都有status属性,该属性的值值可能是字符串fulfilled或字符串rejected,fulfilled时,对象有value属性,rejected时有reason属性。对应两种状态的返回值。
const resolved = Promise.resolve(42);
const rejected = Promise.reject(-1);
const allSettledPromise = Promise.allSettled([resolved, rejected]);
allSettledPromise.then(function (results) {
console.log(results);});
// [
// { status: 'fulfilled', value: 42 },
// { status: 'rejected', reason: -1 }
// ]
用处:当不关心异步操作的结果,只关心这些操作有没有结束,这时,Promise.allSettled方法就可以确保所有操作都结束了。
8:Promise.any (一个成功,就返回成功,都失败才返回失败)
接收一组Promise实例作为参数,包装成一个新的Promise实例返回,只要参数实例有一个变成fulfilled状态,包装实例就会变成fulfilled状态,如果所有参数实例都变成rejected状态,包装实例就会变成rejected状态。
Promise.any()抛出的错误,不是一个一般的错误,而是一个 AggregateError 实例。它相当于一个数组,每个成员对应一个被rejected的操作所抛出的错误。
9:Promise.resolve
将对象转为Promise对象
Promise.resolve('foo')
//等价于
new Promise((resolve)=>resolve('foo'))
Promise.resolve方法的参数情况:
9.1:参数是一个Promise实例
如果参数是Promise实例,那么Promise.resolve将不做任何修改,原封不动的返回这个实例。
9.2:参数是一个thenable对象
thenable对象指的是具有then方法的对象
let thenable = {
then:function(resolve,reject){
resolve(42)
}
}
Promise.resolve()方法会将这个对象转为 Promise 对象,然后就立即执行thenable对象的then()方法。
9.3:参数不是具有then方法的对象,或根本就不是对象。
如果参数是一个原始值,或者是一个不具有then()方法的对象,则Promise.resolve()方法返回一个新的 Promise 对象,状态为resolved。注意此时直接具有resolved状态。
9.4:不带任何参数
Promise.resolve方法允许调用时不带参数,直接返回一个resolved状态的Promise对象。所以,如果希望得到一个Promise对象,比较方便的方法就是直接调用Promise.resolve方法。
const p = Promise.resolve() //创建一个Promise对象。
p.then(()=>{})
注意:立即resolve()的 Promise 对象,是在本轮“事件循环”(event loop)的结束时执行,而不是在下一轮“事件循环”的开始时。
setTimeout(fn, 0)在下一轮“事件循环”开始时执行,Promise.resolve()在本轮“事件循环”结束时执行。
10:Promise.reject
Promise.reject(reason)方法也会返回一个新的Promise实例,该实例的状态为rejected.注意此时直接具有rejected状态。
Promise.reject方法的参数会原封不动的作为reject的理由,变成后续方法的参数。
let obj = {}
Promise.reject(obj).catch(e=>console.log(e === obj)) //true
11:Promise.try(提案)
Promise.try就是模拟try代码块,Promise.catch模拟的是catch代码块。
Promise.try(()=>{}).then().catch()
Promise.catch捕获异步抛出得错误,try...catch捕获同步抛出的错误。