掌握 Promise 的逻辑方法

Promise 是 ES2015 新增的对象

Promise 对象有几个组合方法，可以将多个承诺合并成一个进行处理

分别是 Promise.all, Promise.race, Promise.allSettled, Promise.any

这些方法都可以接收一组承诺，返回一个新的承诺

Promise.all(values)

其中参数 values 是一个可迭代对象，比如数组

在后文中使用词语“成功”表示承诺 resolve，“失败”表示承诺 reject

Promise.all

Promise.all 方法返回的承诺会等到参数中所有的承诺都成功之后才会成功，只要其中有一个失败了则返回的承诺也会立即失败，不会等到那些还挂起的承诺有结果

Promise.all 方法可以用来处理那些缺一不可的逻辑

示例：同时发出多个请求都成功后才能进行下一步

const coffee = fetch('/coffee')
const tea = fetch('/tea')
const me = fetch('/me')

// 我全都要
const res = await Promise.all([coffee, tea, me])

Promise.race

Promise.race 方法返回参数中最快的那个承诺，如果最快的那个承诺成功则返回的承诺也会成功，否则就是失败，不会等到那些还挂起的承诺有结果

示例：给一个复杂任务设定一个超时时间

// 设置一个定时器，时间到了就 reject 一个承诺
const timeout = new Promise((resolve, reject) => {
  setTimeout(reject, 3000)
})

const missions = fetch('/missions')

try {
  const res = await Promise.race([timeout, missions])
  // missions 任务成功
} catch () {
  // 时间超过 3 秒了或者任务失败了
}

Promise.allSettled

Promise.allSettled 方法返回的承诺对象会等到参数中所有的承诺对象都完成后才成功，无论怎样该方法返回的承诺都不会失败

和 Promise.all 方法的区别

Promise.all 方法需要参数中的所有承诺都成功

而 Promise.allSettled 对参数中的承诺是成功还是失败并不关心，只要有结果就行

示例：一次性上传多个文件，其中上传成功和上传失败的互不影响，在一轮上传任务完成之后，可以筛选出那些上传失败的重新上传

const upload = file => {
  const formData = new FormData()
  formData.append('file', file)
  return fetch('/upload', {
    method: 'POST',
    body: formData
  })
}

document.querySelector('input[type="file"]').addEventListener('change', function(e) {
  if (!e.target.value) return
  const files = e.target.files
  const promises = files.map(file => upload(file))

  const res = await Promise.allSettled(promises)
  // 全部上传任务都完成了，找出上传失败的重新上传
})

该方法是 ES2020 新添加的方法

Promise.any

Promise.any 方法返回一组承诺中最快成功的那个承诺，如果参数中所有承诺都失败了，那么返回的承诺也失败

和 Promise.race 方法的区别

Promise.race 返回参数中最快的那个承诺，无论它是成功还是失败

而 Promise.any 关注的是参数中最快同时还必须成功的那个承诺

和 Promise.all 方法的区别

Promise.any 和 Promise.all 是完全相反的

Promise.any 参数中全部承诺都失败了才会失败，Promise.all 参数中全部承诺都成功了才会成功

Promise.any 参数中一旦有一个承诺成功了返回的新承诺就会成功，Promise.all 参数中一旦有一个承诺失败了返回的新承诺就会失败

示例：同时加载一组图片，但是我们只需要用到其中的一张，就可以用 Promise.any 方法挑选出最先加载成功的那张图片

const fetchImg = async (url) => {
  return fetch(url).then(res => {
    if (!res.ok) {
      throw new Error('HTTP error!')
    } else {
      return res.blob()
    }
  })
}

cosnt img1 = fetchImg('/1.png')
const img2 = fetchImg('/2.png')

try {
  const res = await Promise.any([img1, img2])
  const url = URL.createObjectURL(res)
  const img = document.createElement('img')
  img.src = url
  document.body.appendChild(img)
} catch () {
  // 一个都没加载成功 QAQ
}

该方法还处于草案中，目前最新的 Chrome, Firefox, Safari 支持