Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Generic asynchronous iterators for node.js.

branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.markdown

async-it

async-it is a series of generic asynchronous parallel and serial iterators for node.js.

These iterators are based on the ES5 additions to Array (forEach, map, filter, some, any, reduce and reduceRight). reduce and reduceRight are available in serial mode only.

Indexes are only passed to the callback in the aptly-named forEachWithIndex for fear of crowding the callback with little used arguments.

Like their sync counterparts, these iterators work on any object which has a numeric length property.

Usage

See examples/example.js:

var path = require('path'),
    fs = require('fs'),
    asyncItParallel = require('async-it').parallel;

var files = ['foo.txt', 'bar.txt', 'does-not-exist.txt', 'baz.txt'];
files = files.map(function(file) {
  return path.join(__dirname, 'files', file);
});

// select existing files
asyncItParallel.filter(files, function(file, cont) {
  fs.exists(file, function(exists) {
    cont(null, exists);
  });
}, function(err, existingFiles) {
  // collect their content
  asyncItParallel.map(existingFiles, function(file, cont) {
    fs.readFile(file, 'utf8', cont);
  }, function(err, content) {
    // output the ordered content to the console
    console.log(content.join('\n'));
  });
});

// Hi, I'm foo!
// Hello World, this is bar.
// I'm baz.

License

Licensed under the MIT license, Copyright 2010 Tobie Langel.

Something went wrong with that request. Please try again.