记录 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.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)
}