Trickle

If you're looking for a promise-based alternative to this module check out wyt.

Trickle limits function executions based on time. It lets you define the number of executions per a certain amount of milliseconds.

This is particularly useful to obey an API provider's rate limit, for example.

Installation

Note: trickle is called "timetrickle" on npm because someone has occupied the name before I had a chance.

1npm install timetrickle --save

or manually add it to your package.json

Example

1var trickle = require('timetrickle');
2    start = +Date.now();
3
4// Helper function to show the time difference
5function since (time) { return Math.round((time - start) / 1000) + 's'; }
6
7// Limit once per second
8var limit = trickle(1, 1000);
9
10limit(function () {
11    console.log('I am doing an API call here', since(+Date.now()));
12});
13
14limit(function () {
15    console.log('I am doing another API call here', since(+Date.now()));
16});
17
18limit(function () {
19    console.log('I am doing an API call here again', since(+Date.now()));
20});

Will output:

I am doing an API call here 0s
I am doing an API call here again 1s
I am doing another API call here 2s