# 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)
* [eachSeries](#eachSeries)
* [eachLimit](#eachLimit)
* [map](#map)
* [mapSeries](#mapSeries)
* [mapLimit](#mapLimit)
* [filter](#filter)
* [filterSeries](#filterSeries)
* [reject](#reject)
* [rejectSeries](#rejectSeries)
* [reduce](#reduce)
* [reduceRight](#reduceRight)
* [detect](#detect)
* [detectSeries](#detectSeries)
* [sortBy](#sortBy)
* [some](#some)
* [every](#every)
* [concat](#concat)
* [concatSeries](#concatSeries)
### Control Flow
* [series](#series)
* [parallel](#parallel)
* [parallelLimit](#parallellimittasks-limit-callback)
* [whilst](#whilst)
* [doWhilst](#doWhilst)
* [until](#until)
* [doUntil](#doUntil)
* [forever](#forever)
* [waterfall](#waterfall)
* [compose](#compose)
* [applyEach](#applyEach)
* [applyEachSeries](#applyEachSeries)
* [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 onc
没有合适的资源?快使用搜索试试~ 我知道了~
CSS高效开发实战—CSS 3、LESS、SASS、Bootstrap、Foundation源代码
共1071个文件
js:547个
json:71个
md:68个
5星 · 超过95%的资源 需积分: 9 201 下载量 43 浏览量
2015-12-22
10:30:05
上传
评论 3
收藏 5.2MB RAR 举报
温馨提示
CSS高效开发实战—CSS 3、LESS、SASS、Bootstrap、Foundation源码,超新、超全的css技术汇总。
资源详情
资源评论
收起资源包目录
CSS高效开发实战—CSS 3、LESS、SASS、Bootstrap、Foundation源代码 (1071个子文件)
AUTHORS 235B
AUTHORS 157B
AUTHORS 120B
AUTHORS 113B
cake 195B
cake 195B
CHANGELOG 2KB
CHANGELOG 1KB
CHANGELOG 879B
cleancss 5KB
cleancss 5KB
exec.cmd 11B
CNAME 17B
CNAME 16B
simple2.coffee 413B
coffee 198B
coffee 198B
compress_mangle_sourcemap 273B
jsl.conf 3KB
CONTRIBUTORS 524B
foundation.css 136KB
foundation.css 136KB
foundation.min.css 105KB
foundation.min.css 105KB
bootstrap.css 15KB
bootstrap.css 15KB
style.css 13KB
style.css 11KB
normalize.css 7KB
normalize.css 7KB
grid.css 6KB
qunit.css 4KB
qunit.css 4KB
reset.css 918B
main-min.css 862B
test1.css 539B
main.css 497B
main.css 497B
test3.css 362B
test2.css 180B
main.css 112B
ie6.css 25B
custom_options 44B
default_options 11B
glyphicons-halflings-regular.eot 20KB
glyphicons-halflings-regular.eot 20KB
esparse 4KB
esvalidate 6KB
file1 5B
file2 5B
Gemfile 57B
Gemfile 55B
loading.gif 7KB
bigstars.gif 5KB
pagination-splash.gif 5KB
client_bg.gif 4KB
midstars.gif 3KB
smlstars.gif 2KB
icon3.gif 1KB
icon4.gif 716B
icon5.gif 651B
nav-bg.gif 599B
icon1.gif 425B
buyBtn.gif 382B
nst.gif 339B
icon2.gif 256B
box-bg.gif 210B
btn.gif 121B
header-pattern.gif 120B
line-bot.gif 90B
short-comment.gif 63B
add-review.gif 61B
arrow1.gif 49B
bd_bot.gif 43B
.gitattributes 12B
.gitattributes 12B
.gitkeep 1B
.gitkeep 1B
.gitmodules 283B
gzip-size 855B
handling_invalid_files 11B
PIE.htc 28KB
响应式布局样例代码.htm 5KB
index.html 88KB
index.html 16KB
demo.html 13KB
components.html 11KB
index.html 10KB
finance.html 10KB
buying.html 10KB
contacts.html 9KB
renting.html 9KB
index.html 9KB
privacypolicy.html 9KB
js_demo.html 9KB
selling.html 9KB
moving.html 8KB
introduce.html 8KB
bs3.html 6KB
demo.html 6KB
共 1071 条
- 1
- 2
- 3
- 4
- 5
- 6
- 11
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功
评论2
最新资源