node-parallel

Parallel provide a simple way for management of parrallel async/sync call

Parallel

Parallel provide a simple but powerful way for management of parallel async call.

Normally we use async or promise for parallel async control. They can resolve every kind of async control problem we get, but the problem is they've done too much and it's neither easy to remember the complicated APIs nor refactoring the code.

Consider chemzqm/serial if you want to control serial callbacks, they have almost the same API.

Via npm:

npm install node-parallel

Via component:

component install chemzqm/parallel
  • Unified error handling.
  • Timeout support.
  • Immediate finished when error occur.
  • No magic on finished callback, just one function.

You must have component installed for browser usage and mocha, mocha-phantomjs installed for testing.

$ npm install -g component mocha mocha-phantomjs
$ git clone git@github.com:chemzqm/parallel.git
$ cd parallel && npm install
$ make
#run test on server side
$ make test 
#run test through phantomjs
$ make phantomjs 
var Parallel = reuiqre('parallel'); //The name is 'node-parallel' in node environment 
var request = request('superagent');
var parallel = new Parallel();
parallel.timeout(3000);
[1,2,3].forEach(function (n){
  parallel.add(function(done){
    request.get('/user/' + n, function(errres) {
      done(err, res.body.name);
    })
  })
});
parallel.done(function(errresults) {
  if (err) throw err;
  // results => ["jack", "tony", "fat"]; 
});

Init new Parallel instance.

Set the timeout to number ms, default is 10s.

Add Function to parallel, the first argument is a callback function, it should be called with error as first argument and result you need as secound argument.

The callback function is called with error (null or undefined if not exist) and the result array when all the request get finished (or timeout reached).

Note, this function should only be called once.

MIT