npm install asyncp
You could also download an archive (zip or tar.gz) from the asyncp Github Releases.
Node.js & Browser
Currently, asyncp has been tested against Node.js 4.x and 6.x. asyncp is written in ES2015, but transpiled to ES5 using Babel. The distributed npm package contains only ES5 source code.
TODO: The npm package is also distributed with a single complete file of asyncp and a single minified file of asyncp. The complete files are located in
Another benefit of asyncp is that it uses the native Promise implementation. This means you can use the native implementation or another library that implements/shims the Promise/A+ specification (e.g. When.js, Bluebird, Q).
const async = ;const p = async;p; // [1, 2, 3];
Or, you can require/import individual functions:
const map = ;const p =;p; // [1, 2, 3];
API documentation is coming soon, but...
Because this is a port of the async library, the API should be the same. Existing async documentation can be found here. The biggest difference is that there won't be a final callback argument. Instead of the callback, the resolved Promise is equivalent.
Another difference is when an async iteratee, task, callback, etc... could allow multiple result arguments, they will be represented as an array of results in the resolved Promise. This concept is similar to Bluebird.spread.
The following functions in async are missing from asyncp. Some of the functions are not all that useful when working with Promises, but contributions are welcome!
apply=> Use function.bind.
constant=> Use lodash#constant.
memoize=> Use lodash#memoize
- When using collection functions (
detect, etc...), the
collectionpassed into the
iterateeis a reference. This means that for each iteration, it's possible to modify the source collection. It's recommended to use the the
collectionas a read-only reference. This is especially important with
*Limitmethods as the
iterateeis not called in the same tick as the original function call.
Much thanks to Brian Cavalier and others in the #cujojs room on freenode!