记录 Promise 的方法
Promise 是异步编程的一种解决方案,比传统的回调函数或事件更合理和更灵活。
Promise 方法
Promise的原型方法:then/catch/finally,这三种方法很常用,then
用于处理Promise转为fulfilled
状态时的代码,catch
用于处理Promise转为rejected
状态时的代码(当然then
的第二个参数也可处理rejected
状态),而finally
用于不管Promise状态怎样转换都会最终执行的代码。
promise的then方法的第二个参数和catch方法都可以处理rejected状态,但它们之间有一些区别:
then的第二个参数只能处理当前的promise,而catch方法可以处理任意位置的rejected状态。所以,如果多个then方法链式调用中有多个rejected状态,可以在最后使用一个catch方法来处理。
then的第二个参数和catch方法的返回值不同。then的第二个参数返回的是一个新的promise对象,而catch方法返回的是一个值或一个新的promise对象。如果返回的是一个值,则会被自动包装成一个resolved状态的promise。
catch方法比then的第二个参数更简洁,更易读。因为catch方法只处理rejected状态,而then方法需要在第一个参数中同时处理resolved和rejected状态。
Promise的静态方法: Promise.all、Promise.allSettled、Promise.any、Promise.race、Promise.resolve、Promise.reject。
Promise 静态方法
Promise.resolve和Promise.reject用于一开始就创建 fulfilled
或rejected
状态的Promise,其他的静态方法传参是Promise实例数组,差异在于处理实例数组的方式和结果。
Promise.all
并行执行多个Promise对象,并在所有Promise对象都成功时返回一个新的Promise对象,其resolve值为一个包含所有Promise结果的数组,如果其中一个Promise对象失败,则返回一个reject的Promise对象,其值为第一个失败的Promise的reject值。
;(async () => {
const promise1 = Promise.resolve('Hello')
const promise2 = 42
// const promise2 = Promise.reject('Error')
const promise3 = new Promise((resolve, reject) => {
setTimeout(resolve, 1000, 'Goodbye')
})
// const promise4 = Promise.reject('Error2')
try {
const result = await Promise.all([promise1, promise2, promise3])
// 成功输出:[ 'Hello', 42, 'Goodbye' ]
console.log(result)
} catch (e) {
// 失败输出:Error
console.log(e)
}
})()
Promise.allSettled
并行执行多个Promise对象,返回一个新的Promise对象(状态一定是fulfilled),其resolve值为一个包含所有Promise结果的数组,其中每个元素都是对象,包含Promise对象的状态和结果。
;(async () => {
const promise1 = Promise.resolve('Hello')
const promise2 = 42
// const promise2 = Promise.reject('Error')
const promise3 = new Promise((resolve, reject) => {
setTimeout(resolve, 1000, 'Goodbye')
})
// const promise4 = Promise.reject('Error2')
try {
const result = await Promise.allSettled([promise1, promise2, promise3])
// 成功输出:
// [
// { status: 'fulfilled', value: 'Hello' },
// { status: 'fulfilled', value: 42 },
// { status: 'fulfilled', value: 'Goodbye' }
// ]
console.log(result)
// 失败输出:
// [
// { status: 'fulfilled', value: 'Hello' },
// { status: 'rejected', reason: 'Error' },
// { status: 'fulfilled', value: 'Goodbye' }
// ]
} catch(e) {
// 不会执行
console.log('error:', e)
}
Promise.allSettled([promise1, promise2, promise3]).then((result) => {
// 成功输出:
// [
// { status: 'fulfilled', value: 'Hello' },
// { status: 'fulfilled', value: 42 },
// { status: 'fulfilled', value: 'Goodbye' }
// ]
console.log(result)
// 失败输出:
// [
// { status: 'fulfilled', value: 'Hello' },
// { status: 'rejected', reason: 'Error' },
// { status: 'fulfilled', value: 'Goodbye' }
// ]
})
})()
如果需要考虑Promise.allSettled的兼容性,可以利用promise实现:
if (!Promise.allSettled) {
Promise.allSettled = function (promises) {
return new Promise((resolve) => {
const data = [],
len = promises.length
let count = len
for (let i = 0; i < len; i++) {
const promise = promise[i]
promise
.then(
(res) => {
data[i] = { status: 'fulfilled', value: res }
},
(error) => {
data[i] = { status: 'rejected', value: error }
}
)
.finally(() => {
if (i === count) {
resolve(data)
}
})
}
})
}
}
Promise.all和Promise.allSettled的区别:
- Promise.all方法返回的一个Promise对象状态将取决于所有Promise对象的状态。如果其中有任何一个Promise对象被rejected了,那么这个新的Promise对象也会被rejected,并且它的值为第一个被rejected的那个Promise对象的值。
- Promise.allSettled方法返回的一个Promise对象状态一定是fulfilled。这个返回的Promise对象的值是一个数组,数组中包含了所有Promise对象的状态和值信息。即便其中有任何一个Promise对象被rejected了,也不会影响这个新的Promise对象的状态。
- 错误处理方面,Promise.all只能捕获处理第一个错误状态,如果需要处理所有状态需要改造(如:每个promise设置catch处理、同步请求/异步等待)或者使用 Promise.allSettled,具体需要怎么做看自己的需求
Promise.any
并行执行多个Promise对象,并返回一个新的Promise对象,其resolve值为第一个成功的Promise对象的resolve值,如果所有Promise对象都失败,则返回一个reject的Promise对象,其值为一个AggregateError对象,其中包含所有Promise对象的reject值。
const promise1 = Promise.reject("error1")
const promise2 = Promise.reject("error2")
const promise3 = Promise.resolve("success")
// const promise3 = Promise.reject("error3")
Promise.any([promise1, promise2, promise3]).then((value) => {
// 成功输出:success
console.log(value)
}).catch((error) => {
// 失败输出:
// [AggregateError: All promises were rejected] {
// [errors]: [ 'error1', 'error2', 'error3' ]
// }
console.log(error)
})
Promise.race
并行执行多个Promise对象,并返回一个新的Promise对象,其resolve值为第一个完成的Promise对象的resolve值,如果所有Promise对象都失败,则返回一个reject的Promise对象,其值为第一个失败的Promise的reject值。
const promise1 = Promise.reject("error1")
const promise2 = Promise.reject("error2")
const promise3 = Promise.resolve("success")
// const promise3 = Promise.reject("error3")
Promise.race([promise1, promise2, promise3]).then((value) => {
// 成功输出:error1
console.log(value)
}).catch((error) => {
// 失败输出:error1
console.log(error)
})
Promise.race和Promise.any的区别:
Promise.race会在其中任意一个Promise对象状态改变(即fulfilled或rejected)时立即返回结果,而Promise.any只会在其中任意一个Promise对象fulfilled时返回结果。
当所有Promise对象都被rejected时,Promise.race会返回被rejected的Promise对象的结果,而Promise.any会抛出AggregateError异常。
如果Promise.race传入的参数是空数组,它会一直处于pending状态,而Promise.any会立即抛出AggregateError异常。(另外:Promise.all和Promise.allSettled返回fulfilled状态)
使用Promise实现站点预检
这是前几天实现的站点预检:判断所有网站链接是否有效,并返回测试的结果。思路:通过get请求测试,考虑请求之间没有关联、错误处理方面最终选择Promise.allSettled
,代码如下:
// 实现 对多个网站链接预检,判定网站链接是否有效
import { get } from 'https'
import { get as getHttp } from 'http'
import { URL } from 'url'
import { ATagSites } from '@/type'
export const detectSitesValid = (allSites: ATagSites[]) => {
// 遍历 allSites 数组,获取所有网站的链接
const sites: { name: string; url: string }[] = []
allSites.forEach((aTagSites) => {
aTagSites.sites.forEach((site) => {
sites.push({
name: site.name,
url: site.link
})
})
})
// 存储所有网站的请求
const fetchRequests: Promise<string>[] = []
// 存储请求结果
const fetchResults: string[] = []
// 遍历所有网站,发起请求
sites.forEach((site) => {
const { name, url } = site
const { protocol } = new URL(url)
const request = protocol === 'https:' ? get : getHttp
fetchRequests.push(
new Promise((resolve, reject) => {
request(
{
hostname: new URL(url).hostname,
path: new URL(url).pathname,
method: 'GET',
timeout: 30000
},
(res) => {
const { statusCode, statusMessage } = res
fetchResults.push(`${name}, ${url}, ${statusCode || 200}, ${statusMessage || 'OK'}`)
resolve('ok')
}
).on('error', (err) => {
const { message } = err
fetchResults.push(`${name}, ${url}, ${0}, ${message}`)
resolve('error')
})
})
)
})
return Promise.allSettled(fetchRequests)
}