Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lpinca/valvelet
Limit the execution rate of a function
https://github.com/lpinca/valvelet
promise rate-limiting throttle
Last synced: 8 days ago
JSON representation
Limit the execution rate of a function
- Host: GitHub
- URL: https://github.com/lpinca/valvelet
- Owner: lpinca
- License: mit
- Created: 2016-06-02T20:36:08.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-11-29T21:00:44.000Z (11 months ago)
- Last Synced: 2024-10-19T19:55:08.805Z (16 days ago)
- Topics: promise, rate-limiting, throttle
- Language: JavaScript
- Size: 16.6 KB
- Stars: 38
- Watchers: 4
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-nodejs-cn - valvelet - 限制 Promise 访问频率的工具 (包 / 流程控制)
- awesome-nodejs - valvelet - Limit the execution rate of a promise-returning function. (Repository / Control flow)
- awesome-nodejs-cn - valvelet - **star:38** 限制承诺返回函数的执行速度 (包 / 控制流)
- awesome-nodejs - valvelet - Limit the execution rate of a promise-returning function. (Packages / Control flow)
- awesome-nodejs - valvelet - Limit the execution rate of a function - ★ 18 (Control flow)
- awesome-node - valvelet - Limit the execution rate of a promise-returning function. (Packages / Control flow)
README
# valvelet
[![Version npm][npm-valvelet-badge]][npm-valvelet]
[![Build Status][ci-valvelet-badge]][ci-valvelet]
[![Coverage Status][coverage-valvelet-badge]][coverage-valvelet]
This is a small utility to limit the execution rate of a function. It is useful
for scenarios such as REST APIs consumption where the amount of requests per
unit of time should not exceed a given threshold.
This module is very similar to
[`node-function-rate-limit`][function-rate-limit]. The difference is that
`valvelet` works seamlessly with promise-returning functions.
## Install
```
npm install --save valvelet
```
## API
The module exports a single function that takes four arguments.
### `valvelet(fn, limit, interval[, size])`
Returns a function which should be called instead of `fn`.
#### Arguments
- `fn` - The function to rate limit calls to.
- `limit` - The maximum number of allowed calls per `interval`.
- `interval` - The timespan where `limit` is calculated.
- `size` - The maximum size of the internal queue. Defaults to 2^32 - 1 which is
the maximum array size in JavaScript.
#### Return value
A function that returns a promise which resolves to the value returned by the
original `fn` function. When the internal queue is at capacity the returned
promise is rejected.
#### Example
```js
const valvelet = require('valvelet');
const get = valvelet(
function request(i) {
return Promise.resolve(`${i} - ${new Date().toISOString()}`);
},
2,
1000
);
function log(data) {
console.log(data);
}
for (let i = 0; i < 10; i++) {
get(i).then(log);
}
/*
0 - 2016-06-02T20:07:33.843Z
1 - 2016-06-02T20:07:33.844Z
2 - 2016-06-02T20:07:34.846Z
3 - 2016-06-02T20:07:34.846Z
4 - 2016-06-02T20:07:35.846Z
5 - 2016-06-02T20:07:35.846Z
6 - 2016-06-02T20:07:36.848Z
7 - 2016-06-02T20:07:36.848Z
8 - 2016-06-02T20:07:37.851Z
9 - 2016-06-02T20:07:37.851Z
*/
```
## Disclaimers
This module is not a complete solution if you are trying to throttle your
requests to a remote API, but have multiple Node.js processes on the same or
multiple hosts, since the state is not shared between the services. That case
can be addressed by allowing each process to send up to only a fraction of the
total limit. Ex: If you have 4 processes, let each process send up to $limit/4.
## License
[MIT](LICENSE)
[npm-valvelet-badge]: https://img.shields.io/npm/v/valvelet.svg
[npm-valvelet]: https://www.npmjs.com/package/valvelet
[ci-valvelet-badge]:
https://img.shields.io/github/actions/workflow/status/lpinca/valvelet/ci.yml?branch=master&label=CI
[ci-valvelet]:
https://github.com/lpinca/valvelet/actions?query=workflow%3ACI+branch%3Amaster
[coverage-valvelet-badge]:
https://img.shields.io/coveralls/lpinca/valvelet/master.svg
[coverage-valvelet]: https://coveralls.io/r/lpinca/valvelet?branch=master
[function-rate-limit]: https://github.com/wankdanker/node-function-rate-limit