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: {…}}, …]