2024-08-28 07:59:26 +02:00
![Async Logo ](https://raw.githubusercontent.com/caolan/async/master/logo/async-logo_readme.jpg )
2023-07-29 20:33:28 +02:00
2024-08-28 07:59:26 +02:00
![Github Actions CI status ](https://github.com/caolan/async/actions/workflows/ci.yml/badge.svg )
[![NPM version ](https://img.shields.io/npm/v/async.svg )](https://www.npmjs.com/package/async)
2023-07-29 20:33:28 +02:00
[![Coverage Status ](https://coveralls.io/repos/caolan/async/badge.svg?branch=master )](https://coveralls.io/r/caolan/async?branch=master)
[![Join the chat at https://gitter.im/caolan/async ](https://badges.gitter.im/Join%20Chat.svg )](https://gitter.im/caolan/async?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge)
2024-08-28 07:59:26 +02:00
[![jsDelivr Hits ](https://data.jsdelivr.com/v1/package/npm/async/badge?style=rounded )](https://www.jsdelivr.com/package/npm/async)
2023-07-29 20:33:28 +02:00
2024-08-28 07:59:26 +02:00
<!--
|Linux|Windows|MacOS|
|-|-|-|
|[![Linux Build Status](https://dev.azure.com/caolanmcmahon/async/_apis/build/status/caolan.async?branchName=master& jobName=Linux& configuration=Linux%20node_10_x)](https://dev.azure.com/caolanmcmahon/async/_build/latest?definitionId=1& branchName=master) | [![Windows Build Status ](https://dev.azure.com/caolanmcmahon/async/_apis/build/status/caolan.async?branchName=master&jobName=Windows&configuration=Windows%20node_10_x )](https://dev.azure.com/caolanmcmahon/async/_build/latest?definitionId=1& branchName=master) | [![MacOS Build Status ](https://dev.azure.com/caolanmcmahon/async/_apis/build/status/caolan.async?branchName=master&jobName=OSX&configuration=OSX%20node_10_x )](https://dev.azure.com/caolanmcmahon/async/_build/latest?definitionId=1& branchName=master)| -->
2023-07-29 20:33:28 +02:00
2024-08-28 07:59:26 +02:00
Async is a utility module which provides straight-forward, powerful functions for working with [asynchronous JavaScript ](http://caolan.github.io/async/v3/global.html ). Although originally designed for use with [Node.js ](https://nodejs.org/ ) and installable via `npm i async` , it can also be used directly in the browser. An ESM/MJS version is included in the main `async` package that should automatically be used with compatible bundlers such as Webpack and Rollup.
2023-07-29 20:33:28 +02:00
2024-08-28 07:59:26 +02:00
A pure ESM version of Async is available as [`async-es` ](https://www.npmjs.com/package/async-es ).
2023-07-29 20:33:28 +02:00
2024-08-28 07:59:26 +02:00
For Documentation, visit < https: / / caolan . github . io / async / >
2023-07-29 20:33:28 +02:00
2024-08-28 07:59:26 +02:00
*For Async v1.5.x documentation, go [HERE ](https://github.com/caolan/async/blob/v1.5.2/README.md )*
2023-07-29 20:33:28 +02:00
```javascript
2024-08-28 07:59:26 +02:00
// for use with Node-style callbacks...
var async = require("async");
2023-07-29 20:33:28 +02:00
var obj = {dev: "/dev.json", test: "/test.json", prod: "/prod.json"};
var configs = {};
2024-08-28 07:59:26 +02:00
async.forEachOf(obj, (value, key, callback) => {
fs.readFile(__dirname + value, "utf8", (err, data) => {
if (err) return callback(err);
try {
configs[key] = JSON.parse(data);
} catch (e) {
return callback(e);
}
callback();
2023-07-29 20:33:28 +02:00
});
2024-08-28 07:59:26 +02:00
}, err => {
if (err) console.error(err.message);
// configs is now a map of JSON data
doSomethingWith(configs);
2023-07-29 20:33:28 +02:00
});
```
2024-08-28 07:59:26 +02:00
```javascript
var async = require("async");
// ...or ES2017 async functions
async.mapLimit(urls, 5, async function(url) {
const response = await fetch(url)
return response.body
}, (err, results) => {
if (err) throw err
// results is now an array of the response bodies
console.log(results)
})
2023-07-29 20:33:28 +02:00
```