一、Promise的三个状态
-
待定(pending): 初始状态,既没有被兑现,也没有被拒绝;
-
当执行executor中的代码时,处于该状态;
-
-
已兑现(fulfilled): 意味着操作成功完成;
-
执行了resolve时,处于该状态;
-
-
已拒绝(rejected): 意味着操作失败;
-
执行了reject时,处于该状态
-
二、Promise对象的方法
2.1Executor
Executor是在创建Promise时需要传入的一个回调函数,这个回调函数会被立即执行,并且传入两个参数:
new Promise((resolve, reject) => {
console.log("executor代码")
})
通常我们会在Executor中确定我们的Promise状态:
-
通过resolve,可以兑现(fulfilled)Promise的状态,我们也可以称之为已决议(resolved);
-
通过reject,可以拒绝(reject)Promise的状态;
这里需要注意:一旦状态被确定下来,Promise的状态会被 锁死,该Promise的状态是不可更改的
-
在我们调用resolve的时候,如果resolve传入的值本身不是一个Promise,那么会将该Promise的状态变成
兑现(fulfilled);
在之后我们去调用reject时,已经不会有任何的响应了(并不是这行代码不会执行,而是无法改变Promise状态);
new Promise((resolve, reject) => {
resolve("已决议")
reject("已拒绝")
}).then(res => {
console.log("res:", res)
}).catch(err => {
console.log("err:", err)
})
如果resolve中传入的是另外一个Promise,那么这个新Promise会决定原Promise的状态:
new Promise((resolve, reject) => {
resolve(new Promise((resolve, reject) => {
setTimeout(() => {
resolve("第二个Promise的resolve")
}, 3000);
}))
}).then(res => {
console.log("res:", res)
}).catch(err => {
console.log("err:", err)
})
如果resolve中传入的是一个对象,并且这个对象有实现then方法,那么会执行该then方法,并且根据then方法的结果来决定Promise的状态:
new Promise((resolve, reject) => {
resolve({
then: function(resolve_, reject_) {
// resolve_("222")
reject_("err message")
}
})
}).then(res => {
console.log("res:", res)
}).catch(err => {
console.log("err:", err)
})
2.2then方法
2.2.1then方法接受两个参数:
-
fulfilled的回调函数:当状态变成fulfilled时会回调的函数;
-
reject的回调函数:当状态变成reject时会回调的函数;
const promise = new Promise((resolve, reject) => { }) promise.then(res => { console.log("res:", res) }, err => { console.log("err:", err) }) //或 promise.then(res => { console.log("res:", res) }).catch(err => { console.log("err:", err) })
2.2.2then方法多次调用
一个promise对象的then方法是可以被多次调用的:
-
每次调用我们都可以传入对应的fulfilled回调;
当Promise的状态变成fulfilled的时候,这些回调函数都会被执行;
promise.then(res => {
console.log("res1:", res)
})
promise.then(res => {
console.log("res2:", res)
})
promise.then(res => {
console.log("res3:", res)
})
2.2.3. then方法的返回值
then方法本身是有返回值的,它的返回值是一个Promise,所以我们可以进行如下的链式调用:
promise.then(res => {
console.log("res1:", res)
}).then(res => {
console.log("res2:", res)
}).then(res => {
console.log("res3:", res)
})
但是then方法返回的Promise到底处于什么样的状态呢?Promise有三种状态,那么这个Promise处于什么状态呢?
-
当then方法中的回调函数本身在执行的时候,那么它处于pending状态;
-
当then方法中的回调函数返回一个结果时,那么它处于fulfilled状态,并且会将结果作为resolve的参数;
-
如果返回的结果是一个Promise呢?那么这个新Promise的状态会决定then返回Promise的状态;
-
当then方法抛出一个异常时,那么它处于reject状态;
promise.then(res => {
console.log("res1:", res)
// 1.直接返回一个值
return "then function fulfilled"
}).then(res => {
console.log("res2:", res)
// 2.返回Promise
return new Promise((resolve, reject) => {
setTimeout(() => {
resolve("new promise fulfilled")
}, 2000);
})
}).then(res => {
console.log("res3:", res)
// 3.抛出一个异常
throw new Error("error message")
}).catch(err => {
console.log("err:", err.message)
})
2.3. catch方法
catch方法也是Promise对象上的一个方法:它也是放在Promise的原型上的 Promise.prototype.catch
2.3.1. catch方法多次调用
-
一个Promise的catch方法是可以被多次调用的:
-
每次调用我们都可以传入对应的reject回调;
-
当Promise的状态变成reject的时候,这些回调函数都会被执行;
// 1.可以多次调用
promise.catch(err => {
console.log("err:", err)
})
promise.catch(err => {
console.log("err:", err)
})
2.3.2. catch方法的返回值
事实上catch方法也是会返回一个Promise对象的,所以catch方法后面我们可以继续调用then方法或者catch方法:
-
下面的代码,后续是catch中的err2打印,还是then中的res打印呢?
答案是res打印,这是因为catch传入的回调在执行完后,默认状态依然会是fulfilled的;
promise.catch(err => {
console.log("err1:", err)
}).catch(err => {
console.log("err2:", err)
}).then(res => {
console.log("res:", res)
})
那么如果我们希望后续继续执行catch,那么需要抛出一个异常:
promise.catch(err => {
console.log("err1:", err)
throw new Error("error message")
}).then(res => {
console.log("res:", res)
}).catch(err => {
console.log("err2:", err)
})
当然我们依然是可以返回一个Promise的:
promise.catch(err => {
console.log("err1:", err)
return new Promise((resolve, reject) => {
reject("err message")
})
}).then(res => {
console.log("res:", res)
}).catch(err => {
console.log("err2:", err)
})
2.4. finally方法
finally是在ES9(ES2018)中新增的一个特性:表示无论Promise对象无论变成fulfilled还是reject状态,最终都会被执行的代码。
finally方法是不接收参数的,因为无论前面是fulfilled状态,还是reject状态,它都会执行。
const promise = new Promise((resolve, reject) => {
// resolve("fulfilled")
reject("reject")
})
promise.then(res => {
console.log("res:", res)
}).catch(err => {
console.log("err:", err)
}).finally(() => {
console.log("finally action")
})
三、Promise类方法
3.1. resolve方法
有时候我们已经有一个现成的内容了,希望将其转成Promise来使用,这个时候我们可以使用 Promise.resolve 方法来完成。
Promise.resolve的用法相当于new Promise:
Promise.resolve("why")
// 类似于
new Promise((resolve) => resolve("why")
Promise.resolve的参数可能会有几种形态:
情况一:参数本身是Promise
那么会将传入的Promise作为resolve函数的返回值;
Promise.resolve(new Promise((resolve, reject) => {
setTimeout(() => {
resolve("promise argument")
}, 3000);
})).then(res => {
console.log("res:", res)
})
情况二:是一个对象,但是对象中有then方法
Promise.resolve({
then: function(resolve_, reject_) {
// resolve_("222")
reject_("err message")
}
}).then(res => {
console.log("res:", res)
}).catch(err => {
console.log("err:", err)
})
情况三:是一个值或者普通的对象,那么会直接作为fulfilled的结果
Promise.resolve("coderwhy").then(res => {
console.log("res:", res)
})
3.2. reject方法
reject方法类似于resolve方法,只是会将Promise对象的状态设置为reject状态。
Promise.reject的用法相当于new Promise,只是会调用reject:
Promise.reject("why")
// 相当于
new Promise((resolve, reject) => reject("why"))
Promise.reject传入的参数无论是什么形态,都会直接作为reject状态的参数传递到catch的。
3.3. all方法
另外一个类方法是Promise.all:
-
它的作用是将多个Promise包裹在一起形成一个新的Promise;
-
新的Promise状态由包裹的所有Promise共同决定:
-
当所有的Promise状态变成fulfilled状态时,新的Promise状态为fulfilled,并且会将所有Promise的返回值组成一个数组;
-
当有一个Promise状态为reject时,新的Promise状态为reject,并且会将第一个reject的返回值作为参数;
const p1 = new Promise((resolve, reject) => {
setTimeout(() => {
resolve("111")
}, 1000);
})
const p2 = new Promise((resolve, reject) => {
setTimeout(() => {
resolve("222")
}, 2000);
})
const p3 = new Promise((resolve, reject) => {
setTimeout(() => {
resolve("333")
}, 3000);
})
Promise.all([p1, p2, p3]).then(res => {
console.log(res)
}).catch(err => {
console.log(err)
})
3.4. allSettled方法
all方法有一个缺陷:当有其中一个Promise变成reject状态时,新Promise就会立即变成对应的reject状态。
-
那么对于resolved的,以及依然处于pending状态的Promise,我们是获取不到对应的结果的;
-
该方法会在所有的Promise都有结果(settled),无论是fulfilled,还是reject时,才会有最终的状态;
-
并且这个Promise的结果一定是fulfilled的;
-
在ES11(ES2020)中,添加了新的API Promise.allSettled:
const p1 = new Promise((resolve, reject) => { setTimeout(() => { resolve("111") }, 1000); }) const p2 = new Promise((resolve, reject) => { setTimeout(() => { reject("err 222") }, 2000); }) const p3 = new Promise((resolve, reject) => { setTimeout(() => { resolve("333") }, 3000); }) Promise.allSettled([p1, p2, p3]).then(res => { console.log(res) }).catch(err => { console.log(err) })我们来看一下打印的结果:
-
allSettled的结果是一个数组,数组中存放着每一个Promise的结果,并且是对应一个对象的;
-
这个对象中包含status状态,以及对应的value值;
[ { status: 'fulfilled', value: '111' }, { status: 'rejected', reason: 'err 222' }, { status: 'fulfilled', value: '333' } ]
3.5. race方法
如果有一个Promise有了结果,我们就希望决定最终新Promise的状态,那么可以使用race方法:
race是竞技、竞赛的意思,表示多个Promise相互竞争,谁先有结果,那么就使用谁的结果;
const p1 = new Promise((resolve, reject) => {
setTimeout(() => {
resolve("111")
}, 1000);
})
const p2 = new Promise((resolve, reject) => {
setTimeout(() => {
reject("err 222")
}, 2000);
})
const p3 = new Promise((resolve, reject) => {
setTimeout(() => {
resolve("333")
}, 3000);
})
Promise.race([p1, p2, p3]).then(res => {
console.log(res)
}).catch(err => {
console.log(err)
})
3.6. any方法
any方法是ES12中新增的方法,和race方法是类似的:
-
any方法会等到一个fulfilled状态,才会决定新Promise的状态;
-
如果所有的Promise都是reject的,那么也会等到所有的Promise都变成rejected状态;
const p1 = new Promise((resolve, reject) => { setTimeout(() => { reject("111") }, 1000); }) const p2 = new Promise((resolve, reject) => { setTimeout(() => { reject("err 222") }, 2000); }) const p3 = new Promise((resolve, reject) => { setTimeout(() => { resolve("333") }, 3000); }) Promise.any([p1, p2, p3]).then(res => { console.log(res) }).catch(err => { console.log("err:", err) })如果所有的Promise都是reject的,那么会报一个AggregateError的错误。

被折叠的 条评论
为什么被折叠?



