- A+
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.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) }