p-throttler

A promise based throttler capable of limiting execution of parallel tasks

npm install p-throttler
10 848 downloads in the last day
54 222 downloads in the last week
240 793 downloads in the last month

p-throttler

Build Status

A promise based throttler responsible for limiting execution of parallel tasks. The number of parallel tasks may be limited and configured per type.

Installation

$ npm install p-throttler

API

#create(defaultConcurrency, types)

Constructs a new throttler.

The defaultConcurrency is the default maximum concurrent functions being run (-1 to specify no limits).
The types allows you to specify different concurrencies for different types.

Example:

var throttler = PThrottler.create(15, {  // or new PThrottler()
    'network_io': 10,
    'disk_io': 50
});

.enqueue(func, [type]): Promise

Enqueues a function to be ran. The function is expected to return a promise or a value.
The returned promise is resolved when the function finishes execution.

The type argument is optional and can be a string or an array of strings.
Use it to specify the type(s) associated with the function.

The function will run as soon as a free slot is available for every type.
If no type is passed or is unknown, the defaultConcurrency is used.

The execution order is guaranteed for functions enqueued with the exact same type argument.

Example:

```js

var method = function () { return Q.resolve('foo'); };

var throttler = PThrottler.create(15, { 'foo': 1, 'bar': 2 });

// Single type throttler.enqueue(function () { return method(); }, 'foo') .then(function (value) { console.log(value); // foo });

// Multiple type throttler.enqueue(function () { return method(); }, ['foo', 'bar']) .then(function (value) { console.log(value); // foo });

.abort(): Promise

Aborts all current work being done. Returns a promise that is resolved when the current running functions finish to execute.
Any function that was in the queue waiting to be ran is removed immediately.

License

Released under the MIT License.

npm loves you