promise-fun

我打算使用这个空间来记录我的 promise 模块、有用的 promise 模式，以及如何解决常见问题。目前，您可以在下面看到我所有的 promise 模块。

包

不接受新增，但欢迎提出请求。

pify: 将回调风格的函数转换为 Promise
delay: 延迟 Promise 指定的时间
yoctodelay: 延迟 Promise 指定的时间
p-map: 并发地对 Promise 进行映射
p-all: 并发运行返回 Promise 的函数和异步函数，可选择限制并发数
p-event: 通过等待事件发出来将事件转换为 Promise
p-debounce: 对返回 Promise 的函数和异步函数进行防抖
p-throttle: 对返回 Promise 的函数和异步函数进行节流
p-timeout: 在指定时间后使 Promise 超时
p-retry: 重试返回 Promise 的函数或异步函数
p-any: 等待任意一个 Promise 被完成
p-some: 等待指定数量的 Promise 被完成
p-mutex: 确保同一时间只有一个操作访问特定资源
p-locate: 获取满足提供的测试函数的第一个已完成的 Promise
p-limit: 以有限的并发数运行多个返回 Promise 的函数和异步函数
p-series: 串行运行返回 Promise 的函数和异步函数
p-memoize: 缓存返回 Promise 的函数和异步函数
p-pipe: 将返回 Promise 的函数和异步函数组合成可重用的管道
p-props: 类似于 Promise.all()，但适用于 Map 和 Object
p-waterfall: 串行运行返回 Promise 的函数和异步函数，每个函数将其结果传递给下一个
p-cancelable: 创建可取消的 Promise
p-progress: 创建可报告进度的 Promise
p-reflect: 使 Promise 始终以其实际完成值或拒绝原因来完成
p-filter: 并发过滤 Promise
p-reduce: 使用 Promise 将值列表归约为一个 Promise 值
p-settle: 并发处理 Promise，获取它们的完成值或拒绝原因，可选择限制并发数
p-map-series: 串行对 Promise 进行映射
p-each-series: 串行迭代 Promise
p-times: 并发运行返回 Promise 的函数和异步函数指定次数
p-lazy: 创建延迟执行的 Promise，直到调用 .then() 或 .catch() 时才执行
p-whilst: 当条件返回 true 时重复调用函数，然后解析 Promise
p-do-whilst: 重复调用函数，直到条件返回 false，然后解析 Promise
p-forever: 重复运行返回 Promise 的函数和异步函数，直到你终止它
p-wait-for: 等待条件为真
p-min-delay: 延迟 Promise 最小时间
p-try: Promise.try() 的 polyfill - 启动 Promise 链
p-race: 更好的 Promise.race()
p-immediate: 返回在下一个事件循环中解决的 Promise - 类似 setImmediate()
p-time: 测量 Promise 解决所需的时间
p-defer: 创建延迟的 Promise
p-is-promise: 检查某个对象是否为 Promise
p-state: 检查 Promise 的状态
p-queue: 具有并发控制的 Promise 队列
make-synchronous: 使异步函数同步化

基于 `.then`/`.catch` 的包

你通常应该避免使用 .then，除非在特殊情况下。

p-catch-if: 条件性 Promise catch 处理器
p-if: 条件性 Promise 链
p-tap: 在不影响 Promise 链的值或状态的情况下插入操作
p-log: 记录 Promise 的值/错误
p-break: 跳出 Promise 链

常见问题

如何运行 100 个异步/返回 Promise 的函数，但同时只运行 5 个？

这是 p-map 的一个很好的用例。你可能会问为什么不能直接指定一个 Promise 数组。Promise 代表计算的值，而不是计算本身 - 它们是急切的。所以当 p-map 开始读取数组时，所有创建这些 Promise 的操作已经开始运行了。p-map 的工作原理是在映射函数中执行返回 Promise 的函数。这样，Promise 是惰性创建的，可以限制并发性。如果你使用不同的函数来获取每个 Promise，可以考虑使用 p-all。

import pMap from 'p-map';

const urls = [
	'https://sindresorhus.com',
	'https://avajs.dev',
	'https://github.com',
	…
];

console.log(urls.length);
//=> 100

const mapper = url => fetchStats(url); //=> Promise

const result = await pMap(urls, mapper, {concurrency: 5});

console.log(result);
//=> [{url: 'https://sindresorhus.com', stats: {…}}, …]