# Async.js
Async is a utility module which provides straight-forward, powerful functions
for working with asynchronous JavaScript. Although originally designed for
use with [node.js](http://nodejs.org), it can also be used directly in the
browser. Also supports [component](https://github.com/component/component).
Async provides around 20 functions that include the usual 'functional'
suspects (map, reduce, filter, each…) as well as some common patterns
for asynchronous control flow (parallel, series, waterfall…). All these
functions assume you follow the node.js convention of providing a single
callback as the last argument of your async function.
## Quick Examples
```javascript
async.map(['file1','file2','file3'], fs.stat, function(err, results){
// results is now an array of stats for each file
});
async.filter(['file1','file2','file3'], fs.exists, function(results){
// results now equals an array of the existing files
});
async.parallel([
function(){ ... },
function(){ ... }
], callback);
async.series([
function(){ ... },
function(){ ... }
]);
```
There are many more functions available so take a look at the docs below for a
full list. This module aims to be comprehensive, so if you feel anything is
missing please create a GitHub issue for it.
## Common Pitfalls
### Binding a context to an iterator
This section is really about bind, not about async. If you are wondering how to
make async execute your iterators in a given context, or are confused as to why
a method of another library isn't working as an iterator, study this example:
```js
// Here is a simple object with an (unnecessarily roundabout) squaring method
var AsyncSquaringLibrary = {
squareExponent: 2,
square: function(number, callback){
var result = Math.pow(number, this.squareExponent);
setTimeout(function(){
callback(null, result);
}, 200);
}
};
async.map([1, 2, 3], AsyncSquaringLibrary.square, function(err, result){
// result is [NaN, NaN, NaN]
// This fails because the `this.squareExponent` expression in the square
// function is not evaluated in the context of AsyncSquaringLibrary, and is
// therefore undefined.
});
async.map([1, 2, 3], AsyncSquaringLibrary.square.bind(AsyncSquaringLibrary), function(err, result){
// result is [1, 4, 9]
// With the help of bind we can attach a context to the iterator before
// passing it to async. Now the square function will be executed in its
// 'home' AsyncSquaringLibrary context and the value of `this.squareExponent`
// will be as expected.
});
```
## Download
The source is available for download from
[GitHub](http://github.com/caolan/async).
Alternatively, you can install using Node Package Manager (npm):
npm install async
__Development:__ [async.js](https://github.com/caolan/async/raw/master/lib/async.js) - 29.6kb Uncompressed
## In the Browser
So far it's been tested in IE6, IE7, IE8, FF3.6 and Chrome 5. Usage:
```html
<script type="text/javascript" src="async.js"></script>
<script type="text/javascript">
async.map(data, asyncProcess, function(err, results){
alert(results);
});
</script>
```
## Documentation
### Collections
* [each](#each)
* [map](#map)
* [filter](#filter)
* [reject](#reject)
* [reduce](#reduce)
* [detect](#detect)
* [sortBy](#sortBy)
* [some](#some)
* [every](#every)
* [concat](#concat)
### Control Flow
* [series](#series)
* [parallel](#parallel)
* [whilst](#whilst)
* [doWhilst](#doWhilst)
* [until](#until)
* [doUntil](#doUntil)
* [forever](#forever)
* [waterfall](#waterfall)
* [compose](#compose)
* [applyEach](#applyEach)
* [queue](#queue)
* [cargo](#cargo)
* [auto](#auto)
* [iterator](#iterator)
* [apply](#apply)
* [nextTick](#nextTick)
* [times](#times)
* [timesSeries](#timesSeries)
### Utils
* [memoize](#memoize)
* [unmemoize](#unmemoize)
* [log](#log)
* [dir](#dir)
* [noConflict](#noConflict)
## Collections
<a name="forEach" />
<a name="each" />
### each(arr, iterator, callback)
Applies an iterator function to each item in an array, in parallel.
The iterator is called with an item from the list and a callback for when it
has finished. If the iterator passes an error to this callback, the main
callback for the each function is immediately called with the error.
Note, that since this function applies the iterator to each item in parallel
there is no guarantee that the iterator functions will complete in order.
__Arguments__
* arr - An array to iterate over.
* iterator(item, callback) - A function to apply to each item in the array.
The iterator is passed a callback(err) which must be called once it has
completed. If no error has occured, the callback should be run without
arguments or with an explicit null argument.
* callback(err) - A callback which is called after all the iterator functions
have finished, or an error has occurred.
__Example__
```js
// assuming openFiles is an array of file names and saveFile is a function
// to save the modified contents of that file:
async.each(openFiles, saveFile, function(err){
// if any of the saves produced an error, err would equal that error
});
```
---------------------------------------
<a name="forEachSeries" />
<a name="eachSeries" />
### eachSeries(arr, iterator, callback)
The same as each only the iterator is applied to each item in the array in
series. The next iterator is only called once the current one has completed
processing. This means the iterator functions will complete in order.
---------------------------------------
<a name="forEachLimit" />
<a name="eachLimit" />
### eachLimit(arr, limit, iterator, callback)
The same as each only no more than "limit" iterators will be simultaneously
running at any time.
Note that the items are not processed in batches, so there is no guarantee that
the first "limit" iterator functions will complete before any others are
started.
__Arguments__
* arr - An array to iterate over.
* limit - The maximum number of iterators to run at any time.
* iterator(item, callback) - A function to apply to each item in the array.
The iterator is passed a callback(err) which must be called once it has
completed. If no error has occured, the callback should be run without
arguments or with an explicit null argument.
* callback(err) - A callback which is called after all the iterator functions
have finished, or an error has occurred.
__Example__
```js
// Assume documents is an array of JSON objects and requestApi is a
// function that interacts with a rate-limited REST api.
async.eachLimit(documents, 20, requestApi, function(err){
// if any of the saves produced an error, err would equal that error
});
```
---------------------------------------
<a name="map" />
### map(arr, iterator, callback)
Produces a new array of values by mapping each value in the given array through
the iterator function. The iterator is called with an item from the array and a
callback for when it has finished processing. The callback takes 2 arguments,
an error and the transformed item from the array. If the iterator passes an
error to this callback, the main callback for the map function is immediately
called with the error.
Note, that since this function applies the iterator to each item in parallel
there is no guarantee that the iterator functions will complete in order, however
the results array will be in the same order as the original array.
__Arguments__
* arr - An array to iterate over.
* iterator(item, callback) - A function to apply to each item in the array.
The iterator is passed a callback(err, transformed) which must be called once
it has completed with an error (which can be null) and a transformed item.
* callback(err, results) - A callback which is called after all the iterator
functions have finished, or an error has occurred. Results is an array of the
transformed items from the original array.
__Example__
```js
async.map(['file1','file2','file3'], fs.stat, functi
没有合适的资源?快使用搜索试试~ 我知道了~
angularjs+bootstrap+ui-angular(大型网络pos系统)
共2000个文件
svn-base:2505个
js:1366个
json:285个
4星 · 超过85%的资源 需积分: 12 48 下载量 106 浏览量
2016-02-17
00:59:41
上传
评论 2
收藏 12.87MB RAR 举报
温馨提示
angularjs+bootstrap+ui-angular(大型网络pos系统),丰富的ui,详细的指令,controller,数据的交互,基于nodejs 运行
资源推荐
资源详情
资源评论
收起资源包目录
angularjs+bootstrap+ui-angular(大型网络pos系统) (2000个子文件)
benchmark-native.c 613B
bootstrap.css 120KB
bootstrap.min.css 97KB
ieCompatFalse.css 85KB
bootstrap-theme.css 14KB
bootstrap-theme.min.css 13KB
jasmine.css 6KB
jasmine.css 6KB
qunit.css 4KB
qunit.css 4KB
urls.css 4KB
urls.css 3KB
media.css 3KB
functions.css 3KB
extend-nest.css 3KB
style.css 3KB
mocha.css 2KB
extract-and-length.css 2KB
css-3.css 2KB
mixins.css 2KB
selectors.css 2KB
urls.css 2KB
urls.css 1KB
linenumbers-all.css 1KB
mixins-args.css 1KB
css.css 1KB
urls.css 1KB
urls.css 1KB
mixins-guards.css 1KB
extend-selector.css 1KB
linenumbers-mediaquery.css 1KB
rulesets.css 1019B
comments.css 1018B
colors.css 986B
strings.css 884B
extend.css 868B
variables.css 801B
import-reference.css 755B
parens.css 698B
operations.css 696B
mixins-important.css 678B
import.css 640B
linenumbers-comments.css 587B
extend-chaining.css 569B
whitespace.css 544B
scope.css 504B
mixins-pattern.css 487B
extend-exact.css 468B
merge.css 435B
css-escapes.css 419B
app.css 401B
ie-filters.css 392B
compression.css 362B
mixins-named-args.css 356B
extend-media.css 310B
bug_5.css 273B
javascript.css 269B
bug_5.min.css 266B
css-guards.css 205B
extend-clearfix.css 190B
mixins-nested.css 187B
legacy.css 143B
import-once.css 134B
with-banner.css 118B
concat.css 111B
ieCompatTrue.css 106B
mixins-closure.css 89B
simple.css 88B
import-inline.css 84B
imported.css 84B
style.css 76B
input_inline_import.css 76B
cleancssReport.css 75B
customFunctions.css 74B
input_inline_import.css 73B
inline_import.css 72B
input_bannered.css 70B
bar.css 68B
input_one.css 60B
input_bannered.css 47B
input_two.css 47B
import-interpolation.css 44B
variablesAsLess.css 35B
style2.css 35B
style2.css 35B
bar.css 32B
lazy-eval.css 30B
simple.css 28B
nopaths.css 27B
less.css 27B
style3.css 27B
style.css 27B
style3.css 27B
style.css 27B
input_inline_import2.css 26B
import-test-d.css 24B
input_inline_import2.css 23B
charsets.css 18B
variablesAsLess.css 17B
compress.css 16B
共 2000 条
- 1
- 2
- 3
- 4
- 5
- 6
- 20
资源评论
- zenigeba2016-08-19不错的资源,谢谢分享
zhengwh510
- 粉丝: 64
- 资源: 1981
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功