lib-js-util-promise
The lib includes the utilities depicted below:
- promiseFlat - applies function to iterable and executes returned promises concurrently with optional limit
- promiseSleep - promise version of setTimeout
- promiseTimeout - wraps the promise/async function with a timeout so it doesn't run forever
- resolvePromiseCb - calls the callback or resolves the Promise if no cb
- waitForCondition - wait for sometime until an action resolves to a truthy result
Installing
npm install --save https://github.com/bitfinexcom/lib-js-util-promise.git
Testing
npm run test
Usage
const { promiseSleep, promiseTimeout } = require('@bitfinex/lib-js-util-promise')
const someSlowFunc = async () => {
await promiseSleep(5000) // wait 5s
return ['user 1', 'user 2']
}
const main = async () => {
try {
await promiseTimeout(someSlowFunc(), 3000) // wait max 3s
} catch (err) {
console.error(err) // should reach here
}
}
main()
More examples can be found under examples directory!
Authors
关于 @bitfinex/lib-js-util-promise 的常见问题
@bitfinex/lib-js-util-promise 是什么?
Bitfinex Lib Utility for Promises
如何安装 @bitfinex/lib-js-util-promise?
在项目目录运行 npm install @bitfinex/lib-js-util-promise,或使用 pnpm add / yarn add / bun add。
@bitfinex/lib-js-util-promise 支持 TypeScript 吗?
支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。
@bitfinex/lib-js-util-promise 支持 ESM 还是 CommonJS?
以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。
@bitfinex/lib-js-util-promise 需要什么版本的 Node.js?
package.json 的 engines 字段要求 Node.js >=22.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。
@bitfinex/lib-js-util-promise 可以商用吗?
@bitfinex/lib-js-util-promise 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。
@bitfinex/lib-js-util-promise 的下载量有多少?
根据 npm 官方下载统计,@bitfinex/lib-js-util-promise 在 2026/10/08 – 2026/11/06 这 30 天内被下载 6,038 次,日均约 201 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。
@bitfinex/lib-js-util-promise 还在维护吗?
最新版本 2.0.0 发布于 2026/11/07(1 天前);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/08/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。