README

tiny-each-async

Asynchronous iterator function similar to (and inspired by) async.each, with support for concurrency limit and item index.

Usage

each(array, [limit], iterator, [callback])

Arguments:

array - An array of items to iterate through.
[limit] - An (optional) integer for determining how many iterator functions should be run in parallel.
iterator(item, [index], callback) - A function to be applied to each item in the array. When it has finished processing the item then the callback function should be called (in case of a failure with the error argument, otherwise none).
callback(err) - An optional callback function that gets called when either all iterator functions have finished or one of them has returned an error.

Example

var eachAsync = require('tiny-each-async');
var timeouts = [300, 100, 2000];

eachAsync(['file1', 'file2', 'file3'], function(item, index, next) {
  setTimeout(function() {
    console.log(item, index, timeouts[index]);
    next();
  }, timeouts[index]);
}, function(err) {
  return err ? console.error(err.stack) : console.log('all done');
});

For more examples checkout the /examples folder.

FAQ

Why the name?

Other possible names were already taken, and the actual source code is tiny.

Why create another async library?

Because doing your own thing is fun.

What if my iterator function is sync, but I want it && the callback to be async?

Then you might want to use dezalgo.

License

MIT

Usage no npm install needed!