If you need zero-overhead series function call, check out
fastseries. If you need a fast work queue
check out fastq. If you need to run fast
waterfall calls, use fastfall.
The major difference between version 1.x.x and 2.x.x is the order of
results, this is now ready to replace async in every case.
Example for parallel call
var parallel = require('fastparallel')({ // this is a function that will be called // when a parallel completes released: completed, // if you want the results, then here you are results: true})parallel( {}, // what will be this in the functions [something, something, something], // functions to call 42, // the first argument of the functions done // the function to be called when the parallel ends)function something (arg, cb) { setImmediate(cb, null, 'myresult')}function done (err, results) { console.log('parallel completed, results:', results)
Example for each and map calls
var parallel = require('fastparallel')({ // this is a function that will be called // when a parallel completes released: completed, // if you want the results, then here you are // passing false disables map results: true})parallel( {}, // what will be this in the functions something, // functions to call [1, 2, 3], // the first argument of the functions done // the function to be called when the parallel ends)function something (arg, cb) { setImmediate(cb, null, 'myresult')}function done (err, results) {
Caveats
The done function will be called only once, even if more than one error happen.
This library works by caching the latest used function, so that running a new parallel
does not cause any memory allocations.
Why it is so fast?
This library is caching functions a lot.
V8 optimizations: thanks to caching, the functions can be optimized by V8 (if they are optimizable, and I took great care of making them so).
Don't use arrays if you just need a queue. A linked list implemented via processes is much faster if you don't need to access elements in between.
Accept passing a this for the functions. Thanks to this hack, you can extract your functions, and place them in a outer level where they are not created at every execution.