forked from dachan/dach
fixed gitignore
This commit is contained in:
parent
5a1e2a7730
commit
399c7c286e
|
|
@ -1 +0,0 @@
|
|||
../ejs/bin/cli.js
|
||||
|
|
@ -1 +0,0 @@
|
|||
../jake/bin/cli.js
|
||||
|
|
@ -1 +0,0 @@
|
|||
../mime/cli.js
|
||||
File diff suppressed because it is too large
Load Diff
|
|
@ -1,243 +0,0 @@
|
|||
1.3.8 / 2022-02-02
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.1.34
|
||||
- deps: mime-db@~1.51.0
|
||||
* deps: negotiator@0.6.3
|
||||
|
||||
1.3.7 / 2019-04-29
|
||||
==================
|
||||
|
||||
* deps: negotiator@0.6.2
|
||||
- Fix sorting charset, encoding, and language with extra parameters
|
||||
|
||||
1.3.6 / 2019-04-28
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.1.24
|
||||
- deps: mime-db@~1.40.0
|
||||
|
||||
1.3.5 / 2018-02-28
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.1.18
|
||||
- deps: mime-db@~1.33.0
|
||||
|
||||
1.3.4 / 2017-08-22
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.1.16
|
||||
- deps: mime-db@~1.29.0
|
||||
|
||||
1.3.3 / 2016-05-02
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.1.11
|
||||
- deps: mime-db@~1.23.0
|
||||
* deps: negotiator@0.6.1
|
||||
- perf: improve `Accept` parsing speed
|
||||
- perf: improve `Accept-Charset` parsing speed
|
||||
- perf: improve `Accept-Encoding` parsing speed
|
||||
- perf: improve `Accept-Language` parsing speed
|
||||
|
||||
1.3.2 / 2016-03-08
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.1.10
|
||||
- Fix extension of `application/dash+xml`
|
||||
- Update primary extension for `audio/mp4`
|
||||
- deps: mime-db@~1.22.0
|
||||
|
||||
1.3.1 / 2016-01-19
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.1.9
|
||||
- deps: mime-db@~1.21.0
|
||||
|
||||
1.3.0 / 2015-09-29
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.1.7
|
||||
- deps: mime-db@~1.19.0
|
||||
* deps: negotiator@0.6.0
|
||||
- Fix including type extensions in parameters in `Accept` parsing
|
||||
- Fix parsing `Accept` parameters with quoted equals
|
||||
- Fix parsing `Accept` parameters with quoted semicolons
|
||||
- Lazy-load modules from main entry point
|
||||
- perf: delay type concatenation until needed
|
||||
- perf: enable strict mode
|
||||
- perf: hoist regular expressions
|
||||
- perf: remove closures getting spec properties
|
||||
- perf: remove a closure from media type parsing
|
||||
- perf: remove property delete from media type parsing
|
||||
|
||||
1.2.13 / 2015-09-06
|
||||
===================
|
||||
|
||||
* deps: mime-types@~2.1.6
|
||||
- deps: mime-db@~1.18.0
|
||||
|
||||
1.2.12 / 2015-07-30
|
||||
===================
|
||||
|
||||
* deps: mime-types@~2.1.4
|
||||
- deps: mime-db@~1.16.0
|
||||
|
||||
1.2.11 / 2015-07-16
|
||||
===================
|
||||
|
||||
* deps: mime-types@~2.1.3
|
||||
- deps: mime-db@~1.15.0
|
||||
|
||||
1.2.10 / 2015-07-01
|
||||
===================
|
||||
|
||||
* deps: mime-types@~2.1.2
|
||||
- deps: mime-db@~1.14.0
|
||||
|
||||
1.2.9 / 2015-06-08
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.1.1
|
||||
- perf: fix deopt during mapping
|
||||
|
||||
1.2.8 / 2015-06-07
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.1.0
|
||||
- deps: mime-db@~1.13.0
|
||||
* perf: avoid argument reassignment & argument slice
|
||||
* perf: avoid negotiator recursive construction
|
||||
* perf: enable strict mode
|
||||
* perf: remove unnecessary bitwise operator
|
||||
|
||||
1.2.7 / 2015-05-10
|
||||
==================
|
||||
|
||||
* deps: negotiator@0.5.3
|
||||
- Fix media type parameter matching to be case-insensitive
|
||||
|
||||
1.2.6 / 2015-05-07
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.0.11
|
||||
- deps: mime-db@~1.9.1
|
||||
* deps: negotiator@0.5.2
|
||||
- Fix comparing media types with quoted values
|
||||
- Fix splitting media types with quoted commas
|
||||
|
||||
1.2.5 / 2015-03-13
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.0.10
|
||||
- deps: mime-db@~1.8.0
|
||||
|
||||
1.2.4 / 2015-02-14
|
||||
==================
|
||||
|
||||
* Support Node.js 0.6
|
||||
* deps: mime-types@~2.0.9
|
||||
- deps: mime-db@~1.7.0
|
||||
* deps: negotiator@0.5.1
|
||||
- Fix preference sorting to be stable for long acceptable lists
|
||||
|
||||
1.2.3 / 2015-01-31
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.0.8
|
||||
- deps: mime-db@~1.6.0
|
||||
|
||||
1.2.2 / 2014-12-30
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.0.7
|
||||
- deps: mime-db@~1.5.0
|
||||
|
||||
1.2.1 / 2014-12-30
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.0.5
|
||||
- deps: mime-db@~1.3.1
|
||||
|
||||
1.2.0 / 2014-12-19
|
||||
==================
|
||||
|
||||
* deps: negotiator@0.5.0
|
||||
- Fix list return order when large accepted list
|
||||
- Fix missing identity encoding when q=0 exists
|
||||
- Remove dynamic building of Negotiator class
|
||||
|
||||
1.1.4 / 2014-12-10
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.0.4
|
||||
- deps: mime-db@~1.3.0
|
||||
|
||||
1.1.3 / 2014-11-09
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.0.3
|
||||
- deps: mime-db@~1.2.0
|
||||
|
||||
1.1.2 / 2014-10-14
|
||||
==================
|
||||
|
||||
* deps: negotiator@0.4.9
|
||||
- Fix error when media type has invalid parameter
|
||||
|
||||
1.1.1 / 2014-09-28
|
||||
==================
|
||||
|
||||
* deps: mime-types@~2.0.2
|
||||
- deps: mime-db@~1.1.0
|
||||
* deps: negotiator@0.4.8
|
||||
- Fix all negotiations to be case-insensitive
|
||||
- Stable sort preferences of same quality according to client order
|
||||
|
||||
1.1.0 / 2014-09-02
|
||||
==================
|
||||
|
||||
* update `mime-types`
|
||||
|
||||
1.0.7 / 2014-07-04
|
||||
==================
|
||||
|
||||
* Fix wrong type returned from `type` when match after unknown extension
|
||||
|
||||
1.0.6 / 2014-06-24
|
||||
==================
|
||||
|
||||
* deps: negotiator@0.4.7
|
||||
|
||||
1.0.5 / 2014-06-20
|
||||
==================
|
||||
|
||||
* fix crash when unknown extension given
|
||||
|
||||
1.0.4 / 2014-06-19
|
||||
==================
|
||||
|
||||
* use `mime-types`
|
||||
|
||||
1.0.3 / 2014-06-11
|
||||
==================
|
||||
|
||||
* deps: negotiator@0.4.6
|
||||
- Order by specificity when quality is the same
|
||||
|
||||
1.0.2 / 2014-05-29
|
||||
==================
|
||||
|
||||
* Fix interpretation when header not in request
|
||||
* deps: pin negotiator@0.4.5
|
||||
|
||||
1.0.1 / 2014-01-18
|
||||
==================
|
||||
|
||||
* Identity encoding isn't always acceptable
|
||||
* deps: negotiator@~0.4.0
|
||||
|
||||
1.0.0 / 2013-12-27
|
||||
==================
|
||||
|
||||
* Genesis
|
||||
|
|
@ -1,23 +0,0 @@
|
|||
(The MIT License)
|
||||
|
||||
Copyright (c) 2014 Jonathan Ong <me@jongleberry.com>
|
||||
Copyright (c) 2015 Douglas Christopher Wilson <doug@somethingdoug.com>
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining
|
||||
a copy of this software and associated documentation files (the
|
||||
'Software'), to deal in the Software without restriction, including
|
||||
without limitation the rights to use, copy, modify, merge, publish,
|
||||
distribute, sublicense, and/or sell copies of the Software, and to
|
||||
permit persons to whom the Software is furnished to do so, subject to
|
||||
the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be
|
||||
included in all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
|
||||
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
||||
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
||||
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
||||
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
||||
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
|
|
@ -1,140 +0,0 @@
|
|||
# accepts
|
||||
|
||||
[![NPM Version][npm-version-image]][npm-url]
|
||||
[![NPM Downloads][npm-downloads-image]][npm-url]
|
||||
[![Node.js Version][node-version-image]][node-version-url]
|
||||
[![Build Status][github-actions-ci-image]][github-actions-ci-url]
|
||||
[![Test Coverage][coveralls-image]][coveralls-url]
|
||||
|
||||
Higher level content negotiation based on [negotiator](https://www.npmjs.com/package/negotiator).
|
||||
Extracted from [koa](https://www.npmjs.com/package/koa) for general use.
|
||||
|
||||
In addition to negotiator, it allows:
|
||||
|
||||
- Allows types as an array or arguments list, ie `(['text/html', 'application/json'])`
|
||||
as well as `('text/html', 'application/json')`.
|
||||
- Allows type shorthands such as `json`.
|
||||
- Returns `false` when no types match
|
||||
- Treats non-existent headers as `*`
|
||||
|
||||
## Installation
|
||||
|
||||
This is a [Node.js](https://nodejs.org/en/) module available through the
|
||||
[npm registry](https://www.npmjs.com/). Installation is done using the
|
||||
[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):
|
||||
|
||||
```sh
|
||||
$ npm install accepts
|
||||
```
|
||||
|
||||
## API
|
||||
|
||||
```js
|
||||
var accepts = require('accepts')
|
||||
```
|
||||
|
||||
### accepts(req)
|
||||
|
||||
Create a new `Accepts` object for the given `req`.
|
||||
|
||||
#### .charset(charsets)
|
||||
|
||||
Return the first accepted charset. If nothing in `charsets` is accepted,
|
||||
then `false` is returned.
|
||||
|
||||
#### .charsets()
|
||||
|
||||
Return the charsets that the request accepts, in the order of the client's
|
||||
preference (most preferred first).
|
||||
|
||||
#### .encoding(encodings)
|
||||
|
||||
Return the first accepted encoding. If nothing in `encodings` is accepted,
|
||||
then `false` is returned.
|
||||
|
||||
#### .encodings()
|
||||
|
||||
Return the encodings that the request accepts, in the order of the client's
|
||||
preference (most preferred first).
|
||||
|
||||
#### .language(languages)
|
||||
|
||||
Return the first accepted language. If nothing in `languages` is accepted,
|
||||
then `false` is returned.
|
||||
|
||||
#### .languages()
|
||||
|
||||
Return the languages that the request accepts, in the order of the client's
|
||||
preference (most preferred first).
|
||||
|
||||
#### .type(types)
|
||||
|
||||
Return the first accepted type (and it is returned as the same text as what
|
||||
appears in the `types` array). If nothing in `types` is accepted, then `false`
|
||||
is returned.
|
||||
|
||||
The `types` array can contain full MIME types or file extensions. Any value
|
||||
that is not a full MIME types is passed to `require('mime-types').lookup`.
|
||||
|
||||
#### .types()
|
||||
|
||||
Return the types that the request accepts, in the order of the client's
|
||||
preference (most preferred first).
|
||||
|
||||
## Examples
|
||||
|
||||
### Simple type negotiation
|
||||
|
||||
This simple example shows how to use `accepts` to return a different typed
|
||||
respond body based on what the client wants to accept. The server lists it's
|
||||
preferences in order and will get back the best match between the client and
|
||||
server.
|
||||
|
||||
```js
|
||||
var accepts = require('accepts')
|
||||
var http = require('http')
|
||||
|
||||
function app (req, res) {
|
||||
var accept = accepts(req)
|
||||
|
||||
// the order of this list is significant; should be server preferred order
|
||||
switch (accept.type(['json', 'html'])) {
|
||||
case 'json':
|
||||
res.setHeader('Content-Type', 'application/json')
|
||||
res.write('{"hello":"world!"}')
|
||||
break
|
||||
case 'html':
|
||||
res.setHeader('Content-Type', 'text/html')
|
||||
res.write('<b>hello, world!</b>')
|
||||
break
|
||||
default:
|
||||
// the fallback is text/plain, so no need to specify it above
|
||||
res.setHeader('Content-Type', 'text/plain')
|
||||
res.write('hello, world!')
|
||||
break
|
||||
}
|
||||
|
||||
res.end()
|
||||
}
|
||||
|
||||
http.createServer(app).listen(3000)
|
||||
```
|
||||
|
||||
You can test this out with the cURL program:
|
||||
```sh
|
||||
curl -I -H'Accept: text/html' http://localhost:3000/
|
||||
```
|
||||
|
||||
## License
|
||||
|
||||
[MIT](LICENSE)
|
||||
|
||||
[coveralls-image]: https://badgen.net/coveralls/c/github/jshttp/accepts/master
|
||||
[coveralls-url]: https://coveralls.io/r/jshttp/accepts?branch=master
|
||||
[github-actions-ci-image]: https://badgen.net/github/checks/jshttp/accepts/master?label=ci
|
||||
[github-actions-ci-url]: https://github.com/jshttp/accepts/actions/workflows/ci.yml
|
||||
[node-version-image]: https://badgen.net/npm/node/accepts
|
||||
[node-version-url]: https://nodejs.org/en/download
|
||||
[npm-downloads-image]: https://badgen.net/npm/dm/accepts
|
||||
[npm-url]: https://npmjs.org/package/accepts
|
||||
[npm-version-image]: https://badgen.net/npm/v/accepts
|
||||
|
|
@ -1,238 +0,0 @@
|
|||
/*!
|
||||
* accepts
|
||||
* Copyright(c) 2014 Jonathan Ong
|
||||
* Copyright(c) 2015 Douglas Christopher Wilson
|
||||
* MIT Licensed
|
||||
*/
|
||||
|
||||
'use strict'
|
||||
|
||||
/**
|
||||
* Module dependencies.
|
||||
* @private
|
||||
*/
|
||||
|
||||
var Negotiator = require('negotiator')
|
||||
var mime = require('mime-types')
|
||||
|
||||
/**
|
||||
* Module exports.
|
||||
* @public
|
||||
*/
|
||||
|
||||
module.exports = Accepts
|
||||
|
||||
/**
|
||||
* Create a new Accepts object for the given req.
|
||||
*
|
||||
* @param {object} req
|
||||
* @public
|
||||
*/
|
||||
|
||||
function Accepts (req) {
|
||||
if (!(this instanceof Accepts)) {
|
||||
return new Accepts(req)
|
||||
}
|
||||
|
||||
this.headers = req.headers
|
||||
this.negotiator = new Negotiator(req)
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if the given `type(s)` is acceptable, returning
|
||||
* the best match when true, otherwise `undefined`, in which
|
||||
* case you should respond with 406 "Not Acceptable".
|
||||
*
|
||||
* The `type` value may be a single mime type string
|
||||
* such as "application/json", the extension name
|
||||
* such as "json" or an array `["json", "html", "text/plain"]`. When a list
|
||||
* or array is given the _best_ match, if any is returned.
|
||||
*
|
||||
* Examples:
|
||||
*
|
||||
* // Accept: text/html
|
||||
* this.types('html');
|
||||
* // => "html"
|
||||
*
|
||||
* // Accept: text/*, application/json
|
||||
* this.types('html');
|
||||
* // => "html"
|
||||
* this.types('text/html');
|
||||
* // => "text/html"
|
||||
* this.types('json', 'text');
|
||||
* // => "json"
|
||||
* this.types('application/json');
|
||||
* // => "application/json"
|
||||
*
|
||||
* // Accept: text/*, application/json
|
||||
* this.types('image/png');
|
||||
* this.types('png');
|
||||
* // => undefined
|
||||
*
|
||||
* // Accept: text/*;q=.5, application/json
|
||||
* this.types(['html', 'json']);
|
||||
* this.types('html', 'json');
|
||||
* // => "json"
|
||||
*
|
||||
* @param {String|Array} types...
|
||||
* @return {String|Array|Boolean}
|
||||
* @public
|
||||
*/
|
||||
|
||||
Accepts.prototype.type =
|
||||
Accepts.prototype.types = function (types_) {
|
||||
var types = types_
|
||||
|
||||
// support flattened arguments
|
||||
if (types && !Array.isArray(types)) {
|
||||
types = new Array(arguments.length)
|
||||
for (var i = 0; i < types.length; i++) {
|
||||
types[i] = arguments[i]
|
||||
}
|
||||
}
|
||||
|
||||
// no types, return all requested types
|
||||
if (!types || types.length === 0) {
|
||||
return this.negotiator.mediaTypes()
|
||||
}
|
||||
|
||||
// no accept header, return first given type
|
||||
if (!this.headers.accept) {
|
||||
return types[0]
|
||||
}
|
||||
|
||||
var mimes = types.map(extToMime)
|
||||
var accepts = this.negotiator.mediaTypes(mimes.filter(validMime))
|
||||
var first = accepts[0]
|
||||
|
||||
return first
|
||||
? types[mimes.indexOf(first)]
|
||||
: false
|
||||
}
|
||||
|
||||
/**
|
||||
* Return accepted encodings or best fit based on `encodings`.
|
||||
*
|
||||
* Given `Accept-Encoding: gzip, deflate`
|
||||
* an array sorted by quality is returned:
|
||||
*
|
||||
* ['gzip', 'deflate']
|
||||
*
|
||||
* @param {String|Array} encodings...
|
||||
* @return {String|Array}
|
||||
* @public
|
||||
*/
|
||||
|
||||
Accepts.prototype.encoding =
|
||||
Accepts.prototype.encodings = function (encodings_) {
|
||||
var encodings = encodings_
|
||||
|
||||
// support flattened arguments
|
||||
if (encodings && !Array.isArray(encodings)) {
|
||||
encodings = new Array(arguments.length)
|
||||
for (var i = 0; i < encodings.length; i++) {
|
||||
encodings[i] = arguments[i]
|
||||
}
|
||||
}
|
||||
|
||||
// no encodings, return all requested encodings
|
||||
if (!encodings || encodings.length === 0) {
|
||||
return this.negotiator.encodings()
|
||||
}
|
||||
|
||||
return this.negotiator.encodings(encodings)[0] || false
|
||||
}
|
||||
|
||||
/**
|
||||
* Return accepted charsets or best fit based on `charsets`.
|
||||
*
|
||||
* Given `Accept-Charset: utf-8, iso-8859-1;q=0.2, utf-7;q=0.5`
|
||||
* an array sorted by quality is returned:
|
||||
*
|
||||
* ['utf-8', 'utf-7', 'iso-8859-1']
|
||||
*
|
||||
* @param {String|Array} charsets...
|
||||
* @return {String|Array}
|
||||
* @public
|
||||
*/
|
||||
|
||||
Accepts.prototype.charset =
|
||||
Accepts.prototype.charsets = function (charsets_) {
|
||||
var charsets = charsets_
|
||||
|
||||
// support flattened arguments
|
||||
if (charsets && !Array.isArray(charsets)) {
|
||||
charsets = new Array(arguments.length)
|
||||
for (var i = 0; i < charsets.length; i++) {
|
||||
charsets[i] = arguments[i]
|
||||
}
|
||||
}
|
||||
|
||||
// no charsets, return all requested charsets
|
||||
if (!charsets || charsets.length === 0) {
|
||||
return this.negotiator.charsets()
|
||||
}
|
||||
|
||||
return this.negotiator.charsets(charsets)[0] || false
|
||||
}
|
||||
|
||||
/**
|
||||
* Return accepted languages or best fit based on `langs`.
|
||||
*
|
||||
* Given `Accept-Language: en;q=0.8, es, pt`
|
||||
* an array sorted by quality is returned:
|
||||
*
|
||||
* ['es', 'pt', 'en']
|
||||
*
|
||||
* @param {String|Array} langs...
|
||||
* @return {Array|String}
|
||||
* @public
|
||||
*/
|
||||
|
||||
Accepts.prototype.lang =
|
||||
Accepts.prototype.langs =
|
||||
Accepts.prototype.language =
|
||||
Accepts.prototype.languages = function (languages_) {
|
||||
var languages = languages_
|
||||
|
||||
// support flattened arguments
|
||||
if (languages && !Array.isArray(languages)) {
|
||||
languages = new Array(arguments.length)
|
||||
for (var i = 0; i < languages.length; i++) {
|
||||
languages[i] = arguments[i]
|
||||
}
|
||||
}
|
||||
|
||||
// no languages, return all requested languages
|
||||
if (!languages || languages.length === 0) {
|
||||
return this.negotiator.languages()
|
||||
}
|
||||
|
||||
return this.negotiator.languages(languages)[0] || false
|
||||
}
|
||||
|
||||
/**
|
||||
* Convert extnames to mime.
|
||||
*
|
||||
* @param {String} type
|
||||
* @return {String}
|
||||
* @private
|
||||
*/
|
||||
|
||||
function extToMime (type) {
|
||||
return type.indexOf('/') === -1
|
||||
? mime.lookup(type)
|
||||
: type
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if mime is valid.
|
||||
*
|
||||
* @param {String} type
|
||||
* @return {String}
|
||||
* @private
|
||||
*/
|
||||
|
||||
function validMime (type) {
|
||||
return typeof type === 'string'
|
||||
}
|
||||
|
|
@ -1,47 +0,0 @@
|
|||
{
|
||||
"name": "accepts",
|
||||
"description": "Higher-level content negotiation",
|
||||
"version": "1.3.8",
|
||||
"contributors": [
|
||||
"Douglas Christopher Wilson <doug@somethingdoug.com>",
|
||||
"Jonathan Ong <me@jongleberry.com> (http://jongleberry.com)"
|
||||
],
|
||||
"license": "MIT",
|
||||
"repository": "jshttp/accepts",
|
||||
"dependencies": {
|
||||
"mime-types": "~2.1.34",
|
||||
"negotiator": "0.6.3"
|
||||
},
|
||||
"devDependencies": {
|
||||
"deep-equal": "1.0.1",
|
||||
"eslint": "7.32.0",
|
||||
"eslint-config-standard": "14.1.1",
|
||||
"eslint-plugin-import": "2.25.4",
|
||||
"eslint-plugin-markdown": "2.2.1",
|
||||
"eslint-plugin-node": "11.1.0",
|
||||
"eslint-plugin-promise": "4.3.1",
|
||||
"eslint-plugin-standard": "4.1.0",
|
||||
"mocha": "9.2.0",
|
||||
"nyc": "15.1.0"
|
||||
},
|
||||
"files": [
|
||||
"LICENSE",
|
||||
"HISTORY.md",
|
||||
"index.js"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 0.6"
|
||||
},
|
||||
"scripts": {
|
||||
"lint": "eslint .",
|
||||
"test": "mocha --reporter spec --check-leaks --bail test/",
|
||||
"test-ci": "nyc --reporter=lcov --reporter=text npm test",
|
||||
"test-cov": "nyc --reporter=html --reporter=text npm test"
|
||||
},
|
||||
"keywords": [
|
||||
"content",
|
||||
"negotiation",
|
||||
"accept",
|
||||
"accepts"
|
||||
]
|
||||
}
|
||||
|
|
@ -1,345 +0,0 @@
|
|||
declare type CSSColor =
|
||||
| 'aliceblue'
|
||||
| 'antiquewhite'
|
||||
| 'aqua'
|
||||
| 'aquamarine'
|
||||
| 'azure'
|
||||
| 'beige'
|
||||
| 'bisque'
|
||||
| 'black'
|
||||
| 'blanchedalmond'
|
||||
| 'blue'
|
||||
| 'blueviolet'
|
||||
| 'brown'
|
||||
| 'burlywood'
|
||||
| 'cadetblue'
|
||||
| 'chartreuse'
|
||||
| 'chocolate'
|
||||
| 'coral'
|
||||
| 'cornflowerblue'
|
||||
| 'cornsilk'
|
||||
| 'crimson'
|
||||
| 'cyan'
|
||||
| 'darkblue'
|
||||
| 'darkcyan'
|
||||
| 'darkgoldenrod'
|
||||
| 'darkgray'
|
||||
| 'darkgreen'
|
||||
| 'darkgrey'
|
||||
| 'darkkhaki'
|
||||
| 'darkmagenta'
|
||||
| 'darkolivegreen'
|
||||
| 'darkorange'
|
||||
| 'darkorchid'
|
||||
| 'darkred'
|
||||
| 'darksalmon'
|
||||
| 'darkseagreen'
|
||||
| 'darkslateblue'
|
||||
| 'darkslategray'
|
||||
| 'darkslategrey'
|
||||
| 'darkturquoise'
|
||||
| 'darkviolet'
|
||||
| 'deeppink'
|
||||
| 'deepskyblue'
|
||||
| 'dimgray'
|
||||
| 'dimgrey'
|
||||
| 'dodgerblue'
|
||||
| 'firebrick'
|
||||
| 'floralwhite'
|
||||
| 'forestgreen'
|
||||
| 'fuchsia'
|
||||
| 'gainsboro'
|
||||
| 'ghostwhite'
|
||||
| 'gold'
|
||||
| 'goldenrod'
|
||||
| 'gray'
|
||||
| 'green'
|
||||
| 'greenyellow'
|
||||
| 'grey'
|
||||
| 'honeydew'
|
||||
| 'hotpink'
|
||||
| 'indianred'
|
||||
| 'indigo'
|
||||
| 'ivory'
|
||||
| 'khaki'
|
||||
| 'lavender'
|
||||
| 'lavenderblush'
|
||||
| 'lawngreen'
|
||||
| 'lemonchiffon'
|
||||
| 'lightblue'
|
||||
| 'lightcoral'
|
||||
| 'lightcyan'
|
||||
| 'lightgoldenrodyellow'
|
||||
| 'lightgray'
|
||||
| 'lightgreen'
|
||||
| 'lightgrey'
|
||||
| 'lightpink'
|
||||
| 'lightsalmon'
|
||||
| 'lightseagreen'
|
||||
| 'lightskyblue'
|
||||
| 'lightslategray'
|
||||
| 'lightslategrey'
|
||||
| 'lightsteelblue'
|
||||
| 'lightyellow'
|
||||
| 'lime'
|
||||
| 'limegreen'
|
||||
| 'linen'
|
||||
| 'magenta'
|
||||
| 'maroon'
|
||||
| 'mediumaquamarine'
|
||||
| 'mediumblue'
|
||||
| 'mediumorchid'
|
||||
| 'mediumpurple'
|
||||
| 'mediumseagreen'
|
||||
| 'mediumslateblue'
|
||||
| 'mediumspringgreen'
|
||||
| 'mediumturquoise'
|
||||
| 'mediumvioletred'
|
||||
| 'midnightblue'
|
||||
| 'mintcream'
|
||||
| 'mistyrose'
|
||||
| 'moccasin'
|
||||
| 'navajowhite'
|
||||
| 'navy'
|
||||
| 'oldlace'
|
||||
| 'olive'
|
||||
| 'olivedrab'
|
||||
| 'orange'
|
||||
| 'orangered'
|
||||
| 'orchid'
|
||||
| 'palegoldenrod'
|
||||
| 'palegreen'
|
||||
| 'paleturquoise'
|
||||
| 'palevioletred'
|
||||
| 'papayawhip'
|
||||
| 'peachpuff'
|
||||
| 'peru'
|
||||
| 'pink'
|
||||
| 'plum'
|
||||
| 'powderblue'
|
||||
| 'purple'
|
||||
| 'rebeccapurple'
|
||||
| 'red'
|
||||
| 'rosybrown'
|
||||
| 'royalblue'
|
||||
| 'saddlebrown'
|
||||
| 'salmon'
|
||||
| 'sandybrown'
|
||||
| 'seagreen'
|
||||
| 'seashell'
|
||||
| 'sienna'
|
||||
| 'silver'
|
||||
| 'skyblue'
|
||||
| 'slateblue'
|
||||
| 'slategray'
|
||||
| 'slategrey'
|
||||
| 'snow'
|
||||
| 'springgreen'
|
||||
| 'steelblue'
|
||||
| 'tan'
|
||||
| 'teal'
|
||||
| 'thistle'
|
||||
| 'tomato'
|
||||
| 'turquoise'
|
||||
| 'violet'
|
||||
| 'wheat'
|
||||
| 'white'
|
||||
| 'whitesmoke'
|
||||
| 'yellow'
|
||||
| 'yellowgreen';
|
||||
|
||||
declare namespace ansiStyles {
|
||||
interface ColorConvert {
|
||||
/**
|
||||
The RGB color space.
|
||||
|
||||
@param red - (`0`-`255`)
|
||||
@param green - (`0`-`255`)
|
||||
@param blue - (`0`-`255`)
|
||||
*/
|
||||
rgb(red: number, green: number, blue: number): string;
|
||||
|
||||
/**
|
||||
The RGB HEX color space.
|
||||
|
||||
@param hex - A hexadecimal string containing RGB data.
|
||||
*/
|
||||
hex(hex: string): string;
|
||||
|
||||
/**
|
||||
@param keyword - A CSS color name.
|
||||
*/
|
||||
keyword(keyword: CSSColor): string;
|
||||
|
||||
/**
|
||||
The HSL color space.
|
||||
|
||||
@param hue - (`0`-`360`)
|
||||
@param saturation - (`0`-`100`)
|
||||
@param lightness - (`0`-`100`)
|
||||
*/
|
||||
hsl(hue: number, saturation: number, lightness: number): string;
|
||||
|
||||
/**
|
||||
The HSV color space.
|
||||
|
||||
@param hue - (`0`-`360`)
|
||||
@param saturation - (`0`-`100`)
|
||||
@param value - (`0`-`100`)
|
||||
*/
|
||||
hsv(hue: number, saturation: number, value: number): string;
|
||||
|
||||
/**
|
||||
The HSV color space.
|
||||
|
||||
@param hue - (`0`-`360`)
|
||||
@param whiteness - (`0`-`100`)
|
||||
@param blackness - (`0`-`100`)
|
||||
*/
|
||||
hwb(hue: number, whiteness: number, blackness: number): string;
|
||||
|
||||
/**
|
||||
Use a [4-bit unsigned number](https://en.wikipedia.org/wiki/ANSI_escape_code#3/4-bit) to set text color.
|
||||
*/
|
||||
ansi(ansi: number): string;
|
||||
|
||||
/**
|
||||
Use an [8-bit unsigned number](https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit) to set text color.
|
||||
*/
|
||||
ansi256(ansi: number): string;
|
||||
}
|
||||
|
||||
interface CSPair {
|
||||
/**
|
||||
The ANSI terminal control sequence for starting this style.
|
||||
*/
|
||||
readonly open: string;
|
||||
|
||||
/**
|
||||
The ANSI terminal control sequence for ending this style.
|
||||
*/
|
||||
readonly close: string;
|
||||
}
|
||||
|
||||
interface ColorBase {
|
||||
readonly ansi: ColorConvert;
|
||||
readonly ansi256: ColorConvert;
|
||||
readonly ansi16m: ColorConvert;
|
||||
|
||||
/**
|
||||
The ANSI terminal control sequence for ending this color.
|
||||
*/
|
||||
readonly close: string;
|
||||
}
|
||||
|
||||
interface Modifier {
|
||||
/**
|
||||
Resets the current color chain.
|
||||
*/
|
||||
readonly reset: CSPair;
|
||||
|
||||
/**
|
||||
Make text bold.
|
||||
*/
|
||||
readonly bold: CSPair;
|
||||
|
||||
/**
|
||||
Emitting only a small amount of light.
|
||||
*/
|
||||
readonly dim: CSPair;
|
||||
|
||||
/**
|
||||
Make text italic. (Not widely supported)
|
||||
*/
|
||||
readonly italic: CSPair;
|
||||
|
||||
/**
|
||||
Make text underline. (Not widely supported)
|
||||
*/
|
||||
readonly underline: CSPair;
|
||||
|
||||
/**
|
||||
Inverse background and foreground colors.
|
||||
*/
|
||||
readonly inverse: CSPair;
|
||||
|
||||
/**
|
||||
Prints the text, but makes it invisible.
|
||||
*/
|
||||
readonly hidden: CSPair;
|
||||
|
||||
/**
|
||||
Puts a horizontal line through the center of the text. (Not widely supported)
|
||||
*/
|
||||
readonly strikethrough: CSPair;
|
||||
}
|
||||
|
||||
interface ForegroundColor {
|
||||
readonly black: CSPair;
|
||||
readonly red: CSPair;
|
||||
readonly green: CSPair;
|
||||
readonly yellow: CSPair;
|
||||
readonly blue: CSPair;
|
||||
readonly cyan: CSPair;
|
||||
readonly magenta: CSPair;
|
||||
readonly white: CSPair;
|
||||
|
||||
/**
|
||||
Alias for `blackBright`.
|
||||
*/
|
||||
readonly gray: CSPair;
|
||||
|
||||
/**
|
||||
Alias for `blackBright`.
|
||||
*/
|
||||
readonly grey: CSPair;
|
||||
|
||||
readonly blackBright: CSPair;
|
||||
readonly redBright: CSPair;
|
||||
readonly greenBright: CSPair;
|
||||
readonly yellowBright: CSPair;
|
||||
readonly blueBright: CSPair;
|
||||
readonly cyanBright: CSPair;
|
||||
readonly magentaBright: CSPair;
|
||||
readonly whiteBright: CSPair;
|
||||
}
|
||||
|
||||
interface BackgroundColor {
|
||||
readonly bgBlack: CSPair;
|
||||
readonly bgRed: CSPair;
|
||||
readonly bgGreen: CSPair;
|
||||
readonly bgYellow: CSPair;
|
||||
readonly bgBlue: CSPair;
|
||||
readonly bgCyan: CSPair;
|
||||
readonly bgMagenta: CSPair;
|
||||
readonly bgWhite: CSPair;
|
||||
|
||||
/**
|
||||
Alias for `bgBlackBright`.
|
||||
*/
|
||||
readonly bgGray: CSPair;
|
||||
|
||||
/**
|
||||
Alias for `bgBlackBright`.
|
||||
*/
|
||||
readonly bgGrey: CSPair;
|
||||
|
||||
readonly bgBlackBright: CSPair;
|
||||
readonly bgRedBright: CSPair;
|
||||
readonly bgGreenBright: CSPair;
|
||||
readonly bgYellowBright: CSPair;
|
||||
readonly bgBlueBright: CSPair;
|
||||
readonly bgCyanBright: CSPair;
|
||||
readonly bgMagentaBright: CSPair;
|
||||
readonly bgWhiteBright: CSPair;
|
||||
}
|
||||
}
|
||||
|
||||
declare const ansiStyles: {
|
||||
readonly modifier: ansiStyles.Modifier;
|
||||
readonly color: ansiStyles.ForegroundColor & ansiStyles.ColorBase;
|
||||
readonly bgColor: ansiStyles.BackgroundColor & ansiStyles.ColorBase;
|
||||
readonly codes: ReadonlyMap<number, number>;
|
||||
} & ansiStyles.BackgroundColor & ansiStyles.ForegroundColor & ansiStyles.Modifier;
|
||||
|
||||
export = ansiStyles;
|
||||
|
|
@ -1,163 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
const wrapAnsi16 = (fn, offset) => (...args) => {
|
||||
const code = fn(...args);
|
||||
return `\u001B[${code + offset}m`;
|
||||
};
|
||||
|
||||
const wrapAnsi256 = (fn, offset) => (...args) => {
|
||||
const code = fn(...args);
|
||||
return `\u001B[${38 + offset};5;${code}m`;
|
||||
};
|
||||
|
||||
const wrapAnsi16m = (fn, offset) => (...args) => {
|
||||
const rgb = fn(...args);
|
||||
return `\u001B[${38 + offset};2;${rgb[0]};${rgb[1]};${rgb[2]}m`;
|
||||
};
|
||||
|
||||
const ansi2ansi = n => n;
|
||||
const rgb2rgb = (r, g, b) => [r, g, b];
|
||||
|
||||
const setLazyProperty = (object, property, get) => {
|
||||
Object.defineProperty(object, property, {
|
||||
get: () => {
|
||||
const value = get();
|
||||
|
||||
Object.defineProperty(object, property, {
|
||||
value,
|
||||
enumerable: true,
|
||||
configurable: true
|
||||
});
|
||||
|
||||
return value;
|
||||
},
|
||||
enumerable: true,
|
||||
configurable: true
|
||||
});
|
||||
};
|
||||
|
||||
/** @type {typeof import('color-convert')} */
|
||||
let colorConvert;
|
||||
const makeDynamicStyles = (wrap, targetSpace, identity, isBackground) => {
|
||||
if (colorConvert === undefined) {
|
||||
colorConvert = require('color-convert');
|
||||
}
|
||||
|
||||
const offset = isBackground ? 10 : 0;
|
||||
const styles = {};
|
||||
|
||||
for (const [sourceSpace, suite] of Object.entries(colorConvert)) {
|
||||
const name = sourceSpace === 'ansi16' ? 'ansi' : sourceSpace;
|
||||
if (sourceSpace === targetSpace) {
|
||||
styles[name] = wrap(identity, offset);
|
||||
} else if (typeof suite === 'object') {
|
||||
styles[name] = wrap(suite[targetSpace], offset);
|
||||
}
|
||||
}
|
||||
|
||||
return styles;
|
||||
};
|
||||
|
||||
function assembleStyles() {
|
||||
const codes = new Map();
|
||||
const styles = {
|
||||
modifier: {
|
||||
reset: [0, 0],
|
||||
// 21 isn't widely supported and 22 does the same thing
|
||||
bold: [1, 22],
|
||||
dim: [2, 22],
|
||||
italic: [3, 23],
|
||||
underline: [4, 24],
|
||||
inverse: [7, 27],
|
||||
hidden: [8, 28],
|
||||
strikethrough: [9, 29]
|
||||
},
|
||||
color: {
|
||||
black: [30, 39],
|
||||
red: [31, 39],
|
||||
green: [32, 39],
|
||||
yellow: [33, 39],
|
||||
blue: [34, 39],
|
||||
magenta: [35, 39],
|
||||
cyan: [36, 39],
|
||||
white: [37, 39],
|
||||
|
||||
// Bright color
|
||||
blackBright: [90, 39],
|
||||
redBright: [91, 39],
|
||||
greenBright: [92, 39],
|
||||
yellowBright: [93, 39],
|
||||
blueBright: [94, 39],
|
||||
magentaBright: [95, 39],
|
||||
cyanBright: [96, 39],
|
||||
whiteBright: [97, 39]
|
||||
},
|
||||
bgColor: {
|
||||
bgBlack: [40, 49],
|
||||
bgRed: [41, 49],
|
||||
bgGreen: [42, 49],
|
||||
bgYellow: [43, 49],
|
||||
bgBlue: [44, 49],
|
||||
bgMagenta: [45, 49],
|
||||
bgCyan: [46, 49],
|
||||
bgWhite: [47, 49],
|
||||
|
||||
// Bright color
|
||||
bgBlackBright: [100, 49],
|
||||
bgRedBright: [101, 49],
|
||||
bgGreenBright: [102, 49],
|
||||
bgYellowBright: [103, 49],
|
||||
bgBlueBright: [104, 49],
|
||||
bgMagentaBright: [105, 49],
|
||||
bgCyanBright: [106, 49],
|
||||
bgWhiteBright: [107, 49]
|
||||
}
|
||||
};
|
||||
|
||||
// Alias bright black as gray (and grey)
|
||||
styles.color.gray = styles.color.blackBright;
|
||||
styles.bgColor.bgGray = styles.bgColor.bgBlackBright;
|
||||
styles.color.grey = styles.color.blackBright;
|
||||
styles.bgColor.bgGrey = styles.bgColor.bgBlackBright;
|
||||
|
||||
for (const [groupName, group] of Object.entries(styles)) {
|
||||
for (const [styleName, style] of Object.entries(group)) {
|
||||
styles[styleName] = {
|
||||
open: `\u001B[${style[0]}m`,
|
||||
close: `\u001B[${style[1]}m`
|
||||
};
|
||||
|
||||
group[styleName] = styles[styleName];
|
||||
|
||||
codes.set(style[0], style[1]);
|
||||
}
|
||||
|
||||
Object.defineProperty(styles, groupName, {
|
||||
value: group,
|
||||
enumerable: false
|
||||
});
|
||||
}
|
||||
|
||||
Object.defineProperty(styles, 'codes', {
|
||||
value: codes,
|
||||
enumerable: false
|
||||
});
|
||||
|
||||
styles.color.close = '\u001B[39m';
|
||||
styles.bgColor.close = '\u001B[49m';
|
||||
|
||||
setLazyProperty(styles.color, 'ansi', () => makeDynamicStyles(wrapAnsi16, 'ansi16', ansi2ansi, false));
|
||||
setLazyProperty(styles.color, 'ansi256', () => makeDynamicStyles(wrapAnsi256, 'ansi256', ansi2ansi, false));
|
||||
setLazyProperty(styles.color, 'ansi16m', () => makeDynamicStyles(wrapAnsi16m, 'rgb', rgb2rgb, false));
|
||||
setLazyProperty(styles.bgColor, 'ansi', () => makeDynamicStyles(wrapAnsi16, 'ansi16', ansi2ansi, true));
|
||||
setLazyProperty(styles.bgColor, 'ansi256', () => makeDynamicStyles(wrapAnsi256, 'ansi256', ansi2ansi, true));
|
||||
setLazyProperty(styles.bgColor, 'ansi16m', () => makeDynamicStyles(wrapAnsi16m, 'rgb', rgb2rgb, true));
|
||||
|
||||
return styles;
|
||||
}
|
||||
|
||||
// Make the export immutable
|
||||
Object.defineProperty(module, 'exports', {
|
||||
enumerable: true,
|
||||
get: assembleStyles
|
||||
});
|
||||
|
|
@ -1,9 +0,0 @@
|
|||
MIT License
|
||||
|
||||
Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
|
|
@ -1,56 +0,0 @@
|
|||
{
|
||||
"name": "ansi-styles",
|
||||
"version": "4.3.0",
|
||||
"description": "ANSI escape codes for styling strings in the terminal",
|
||||
"license": "MIT",
|
||||
"repository": "chalk/ansi-styles",
|
||||
"funding": "https://github.com/chalk/ansi-styles?sponsor=1",
|
||||
"author": {
|
||||
"name": "Sindre Sorhus",
|
||||
"email": "sindresorhus@gmail.com",
|
||||
"url": "sindresorhus.com"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=8"
|
||||
},
|
||||
"scripts": {
|
||||
"test": "xo && ava && tsd",
|
||||
"screenshot": "svg-term --command='node screenshot' --out=screenshot.svg --padding=3 --width=55 --height=3 --at=1000 --no-cursor"
|
||||
},
|
||||
"files": [
|
||||
"index.js",
|
||||
"index.d.ts"
|
||||
],
|
||||
"keywords": [
|
||||
"ansi",
|
||||
"styles",
|
||||
"color",
|
||||
"colour",
|
||||
"colors",
|
||||
"terminal",
|
||||
"console",
|
||||
"cli",
|
||||
"string",
|
||||
"tty",
|
||||
"escape",
|
||||
"formatting",
|
||||
"rgb",
|
||||
"256",
|
||||
"shell",
|
||||
"xterm",
|
||||
"log",
|
||||
"logging",
|
||||
"command-line",
|
||||
"text"
|
||||
],
|
||||
"dependencies": {
|
||||
"color-convert": "^2.0.1"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/color-convert": "^1.9.0",
|
||||
"ava": "^2.3.0",
|
||||
"svg-term-cli": "^2.1.1",
|
||||
"tsd": "^0.11.0",
|
||||
"xo": "^0.25.3"
|
||||
}
|
||||
}
|
||||
|
|
@ -1,152 +0,0 @@
|
|||
# ansi-styles [](https://travis-ci.org/chalk/ansi-styles)
|
||||
|
||||
> [ANSI escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors_and_Styles) for styling strings in the terminal
|
||||
|
||||
You probably want the higher-level [chalk](https://github.com/chalk/chalk) module for styling your strings.
|
||||
|
||||
<img src="screenshot.svg" width="900">
|
||||
|
||||
## Install
|
||||
|
||||
```
|
||||
$ npm install ansi-styles
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
```js
|
||||
const style = require('ansi-styles');
|
||||
|
||||
console.log(`${style.green.open}Hello world!${style.green.close}`);
|
||||
|
||||
|
||||
// Color conversion between 16/256/truecolor
|
||||
// NOTE: If conversion goes to 16 colors or 256 colors, the original color
|
||||
// may be degraded to fit that color palette. This means terminals
|
||||
// that do not support 16 million colors will best-match the
|
||||
// original color.
|
||||
console.log(style.bgColor.ansi.hsl(120, 80, 72) + 'Hello world!' + style.bgColor.close);
|
||||
console.log(style.color.ansi256.rgb(199, 20, 250) + 'Hello world!' + style.color.close);
|
||||
console.log(style.color.ansi16m.hex('#abcdef') + 'Hello world!' + style.color.close);
|
||||
```
|
||||
|
||||
## API
|
||||
|
||||
Each style has an `open` and `close` property.
|
||||
|
||||
## Styles
|
||||
|
||||
### Modifiers
|
||||
|
||||
- `reset`
|
||||
- `bold`
|
||||
- `dim`
|
||||
- `italic` *(Not widely supported)*
|
||||
- `underline`
|
||||
- `inverse`
|
||||
- `hidden`
|
||||
- `strikethrough` *(Not widely supported)*
|
||||
|
||||
### Colors
|
||||
|
||||
- `black`
|
||||
- `red`
|
||||
- `green`
|
||||
- `yellow`
|
||||
- `blue`
|
||||
- `magenta`
|
||||
- `cyan`
|
||||
- `white`
|
||||
- `blackBright` (alias: `gray`, `grey`)
|
||||
- `redBright`
|
||||
- `greenBright`
|
||||
- `yellowBright`
|
||||
- `blueBright`
|
||||
- `magentaBright`
|
||||
- `cyanBright`
|
||||
- `whiteBright`
|
||||
|
||||
### Background colors
|
||||
|
||||
- `bgBlack`
|
||||
- `bgRed`
|
||||
- `bgGreen`
|
||||
- `bgYellow`
|
||||
- `bgBlue`
|
||||
- `bgMagenta`
|
||||
- `bgCyan`
|
||||
- `bgWhite`
|
||||
- `bgBlackBright` (alias: `bgGray`, `bgGrey`)
|
||||
- `bgRedBright`
|
||||
- `bgGreenBright`
|
||||
- `bgYellowBright`
|
||||
- `bgBlueBright`
|
||||
- `bgMagentaBright`
|
||||
- `bgCyanBright`
|
||||
- `bgWhiteBright`
|
||||
|
||||
## Advanced usage
|
||||
|
||||
By default, you get a map of styles, but the styles are also available as groups. They are non-enumerable so they don't show up unless you access them explicitly. This makes it easier to expose only a subset in a higher-level module.
|
||||
|
||||
- `style.modifier`
|
||||
- `style.color`
|
||||
- `style.bgColor`
|
||||
|
||||
###### Example
|
||||
|
||||
```js
|
||||
console.log(style.color.green.open);
|
||||
```
|
||||
|
||||
Raw escape codes (i.e. without the CSI escape prefix `\u001B[` and render mode postfix `m`) are available under `style.codes`, which returns a `Map` with the open codes as keys and close codes as values.
|
||||
|
||||
###### Example
|
||||
|
||||
```js
|
||||
console.log(style.codes.get(36));
|
||||
//=> 39
|
||||
```
|
||||
|
||||
## [256 / 16 million (TrueColor) support](https://gist.github.com/XVilka/8346728)
|
||||
|
||||
`ansi-styles` uses the [`color-convert`](https://github.com/Qix-/color-convert) package to allow for converting between various colors and ANSI escapes, with support for 256 and 16 million colors.
|
||||
|
||||
The following color spaces from `color-convert` are supported:
|
||||
|
||||
- `rgb`
|
||||
- `hex`
|
||||
- `keyword`
|
||||
- `hsl`
|
||||
- `hsv`
|
||||
- `hwb`
|
||||
- `ansi`
|
||||
- `ansi256`
|
||||
|
||||
To use these, call the associated conversion function with the intended output, for example:
|
||||
|
||||
```js
|
||||
style.color.ansi.rgb(100, 200, 15); // RGB to 16 color ansi foreground code
|
||||
style.bgColor.ansi.rgb(100, 200, 15); // RGB to 16 color ansi background code
|
||||
|
||||
style.color.ansi256.hsl(120, 100, 60); // HSL to 256 color ansi foreground code
|
||||
style.bgColor.ansi256.hsl(120, 100, 60); // HSL to 256 color ansi foreground code
|
||||
|
||||
style.color.ansi16m.hex('#C0FFEE'); // Hex (RGB) to 16 million color foreground code
|
||||
style.bgColor.ansi16m.hex('#C0FFEE'); // Hex (RGB) to 16 million color background code
|
||||
```
|
||||
|
||||
## Related
|
||||
|
||||
- [ansi-escapes](https://github.com/sindresorhus/ansi-escapes) - ANSI escape codes for manipulating the terminal
|
||||
|
||||
## Maintainers
|
||||
|
||||
- [Sindre Sorhus](https://github.com/sindresorhus)
|
||||
- [Josh Junon](https://github.com/qix-)
|
||||
|
||||
## For enterprise
|
||||
|
||||
Available as part of the Tidelift Subscription.
|
||||
|
||||
The maintainers of `ansi-styles` and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/npm-ansi-styles?utm_source=npm-ansi-styles&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)
|
||||
|
|
@ -1,21 +0,0 @@
|
|||
The MIT License (MIT)
|
||||
|
||||
Copyright (c) 2014 Blake Embrey (hello@blakeembrey.com)
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in
|
||||
all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||
THE SOFTWARE.
|
||||
|
|
@ -1,43 +0,0 @@
|
|||
# Array Flatten
|
||||
|
||||
[![NPM version][npm-image]][npm-url]
|
||||
[![NPM downloads][downloads-image]][downloads-url]
|
||||
[![Build status][travis-image]][travis-url]
|
||||
[![Test coverage][coveralls-image]][coveralls-url]
|
||||
|
||||
> Flatten an array of nested arrays into a single flat array. Accepts an optional depth.
|
||||
|
||||
## Installation
|
||||
|
||||
```
|
||||
npm install array-flatten --save
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
```javascript
|
||||
var flatten = require('array-flatten')
|
||||
|
||||
flatten([1, [2, [3, [4, [5], 6], 7], 8], 9])
|
||||
//=> [1, 2, 3, 4, 5, 6, 7, 8, 9]
|
||||
|
||||
flatten([1, [2, [3, [4, [5], 6], 7], 8], 9], 2)
|
||||
//=> [1, 2, 3, [4, [5], 6], 7, 8, 9]
|
||||
|
||||
(function () {
|
||||
flatten(arguments) //=> [1, 2, 3]
|
||||
})(1, [2, 3])
|
||||
```
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
|
||||
[npm-image]: https://img.shields.io/npm/v/array-flatten.svg?style=flat
|
||||
[npm-url]: https://npmjs.org/package/array-flatten
|
||||
[downloads-image]: https://img.shields.io/npm/dm/array-flatten.svg?style=flat
|
||||
[downloads-url]: https://npmjs.org/package/array-flatten
|
||||
[travis-image]: https://img.shields.io/travis/blakeembrey/array-flatten.svg?style=flat
|
||||
[travis-url]: https://travis-ci.org/blakeembrey/array-flatten
|
||||
[coveralls-image]: https://img.shields.io/coveralls/blakeembrey/array-flatten.svg?style=flat
|
||||
[coveralls-url]: https://coveralls.io/r/blakeembrey/array-flatten?branch=master
|
||||
|
|
@ -1,64 +0,0 @@
|
|||
'use strict'
|
||||
|
||||
/**
|
||||
* Expose `arrayFlatten`.
|
||||
*/
|
||||
module.exports = arrayFlatten
|
||||
|
||||
/**
|
||||
* Recursive flatten function with depth.
|
||||
*
|
||||
* @param {Array} array
|
||||
* @param {Array} result
|
||||
* @param {Number} depth
|
||||
* @return {Array}
|
||||
*/
|
||||
function flattenWithDepth (array, result, depth) {
|
||||
for (var i = 0; i < array.length; i++) {
|
||||
var value = array[i]
|
||||
|
||||
if (depth > 0 && Array.isArray(value)) {
|
||||
flattenWithDepth(value, result, depth - 1)
|
||||
} else {
|
||||
result.push(value)
|
||||
}
|
||||
}
|
||||
|
||||
return result
|
||||
}
|
||||
|
||||
/**
|
||||
* Recursive flatten function. Omitting depth is slightly faster.
|
||||
*
|
||||
* @param {Array} array
|
||||
* @param {Array} result
|
||||
* @return {Array}
|
||||
*/
|
||||
function flattenForever (array, result) {
|
||||
for (var i = 0; i < array.length; i++) {
|
||||
var value = array[i]
|
||||
|
||||
if (Array.isArray(value)) {
|
||||
flattenForever(value, result)
|
||||
} else {
|
||||
result.push(value)
|
||||
}
|
||||
}
|
||||
|
||||
return result
|
||||
}
|
||||
|
||||
/**
|
||||
* Flatten an array, with the ability to define a depth.
|
||||
*
|
||||
* @param {Array} array
|
||||
* @param {Number} depth
|
||||
* @return {Array}
|
||||
*/
|
||||
function arrayFlatten (array, depth) {
|
||||
if (depth == null) {
|
||||
return flattenForever(array, [])
|
||||
}
|
||||
|
||||
return flattenWithDepth(array, [], depth)
|
||||
}
|
||||
|
|
@ -1,39 +0,0 @@
|
|||
{
|
||||
"name": "array-flatten",
|
||||
"version": "1.1.1",
|
||||
"description": "Flatten an array of nested arrays into a single flat array",
|
||||
"main": "array-flatten.js",
|
||||
"files": [
|
||||
"array-flatten.js",
|
||||
"LICENSE"
|
||||
],
|
||||
"scripts": {
|
||||
"test": "istanbul cover _mocha -- -R spec"
|
||||
},
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "git://github.com/blakeembrey/array-flatten.git"
|
||||
},
|
||||
"keywords": [
|
||||
"array",
|
||||
"flatten",
|
||||
"arguments",
|
||||
"depth"
|
||||
],
|
||||
"author": {
|
||||
"name": "Blake Embrey",
|
||||
"email": "hello@blakeembrey.com",
|
||||
"url": "http://blakeembrey.me"
|
||||
},
|
||||
"license": "MIT",
|
||||
"bugs": {
|
||||
"url": "https://github.com/blakeembrey/array-flatten/issues"
|
||||
},
|
||||
"homepage": "https://github.com/blakeembrey/array-flatten",
|
||||
"devDependencies": {
|
||||
"istanbul": "^0.3.13",
|
||||
"mocha": "^2.2.4",
|
||||
"pre-commit": "^1.0.7",
|
||||
"standard": "^3.7.3"
|
||||
}
|
||||
}
|
||||
|
|
@ -1,348 +0,0 @@
|
|||
# v3.2.4
|
||||
- Fix a bug in `priorityQueue` where it didn't wait for the result. (#1725)
|
||||
- Fix a bug where `unshiftAsync` was included in `priorityQueue`. (#1790)
|
||||
|
||||
# v3.2.3
|
||||
- Fix bugs in comment parsing in `autoInject`. (#1767, #1780)
|
||||
|
||||
# v3.2.2
|
||||
- Fix potential prototype pollution exploit
|
||||
|
||||
# v3.2.1
|
||||
- Use `queueMicrotask` if available to the environment (#1761)
|
||||
- Minor perf improvement in `priorityQueue` (#1727)
|
||||
- More examples in documentation (#1726)
|
||||
- Various doc fixes (#1708, #1712, #1717, #1740, #1739, #1749, #1756)
|
||||
- Improved test coverage (#1754)
|
||||
|
||||
# v3.2.0
|
||||
- Fix a bug in Safari related to overwriting `func.name`
|
||||
- Remove built-in browserify configuration (#1653)
|
||||
- Varios doc fixes (#1688, #1703, #1704)
|
||||
|
||||
# v3.1.1
|
||||
- Allow redefining `name` property on wrapped functions.
|
||||
|
||||
# v3.1.0
|
||||
|
||||
- Added `q.pushAsync` and `q.unshiftAsync`, analagous to `q.push` and `q.unshift`, except they always do not accept a callback, and reject if processing the task errors. (#1659)
|
||||
- Promises returned from `q.push` and `q.unshift` when a callback is not passed now resolve even if an error ocurred. (#1659)
|
||||
- Fixed a parsing bug in `autoInject` with complicated function bodies (#1663)
|
||||
- Added ES6+ configuration for Browserify bundlers (#1653)
|
||||
- Various doc fixes (#1664, #1658, #1665, #1652)
|
||||
|
||||
# v3.0.1
|
||||
|
||||
## Bug fixes
|
||||
- Fixed a regression where arrays passed to `queue` and `cargo` would be completely flattened. (#1645)
|
||||
- Clarified Async's browser support (#1643)
|
||||
|
||||
|
||||
# v3.0.0
|
||||
|
||||
The `async`/`await` release!
|
||||
|
||||
There are a lot of new features and subtle breaking changes in this major version, but the biggest feature is that most Async methods return a Promise if you omit the callback, meaning you can `await` them from within an `async` function.
|
||||
|
||||
```js
|
||||
const results = await async.mapLimit(urls, 5, async url => {
|
||||
const resp = await fetch(url)
|
||||
return resp.body
|
||||
})
|
||||
```
|
||||
|
||||
## Breaking Changes
|
||||
- Most Async methods return a Promise when the final callback is omitted, making them `await`-able! (#1572)
|
||||
- We are now making heavy use of ES2015 features, this means we have dropped out-of-the-box support for Node 4 and earlier, and many old versions of browsers. (#1541, #1553)
|
||||
- In `queue`, `priorityQueue`, `cargo` and `cargoQueue`, the "event"-style methods, like `q.drain` and `q.saturated` are now methods that register a callback, rather than properties you assign a callback to. They are now of the form `q.drain(callback)`. If you do not pass a callback a Promise will be returned for the next occurrence of the event, making them `await`-able, e.g. `await q.drain()`. (#1586, #1641)
|
||||
- Calling `callback(false)` will cancel an async method, preventing further iteration and callback calls. This is useful for preventing memory leaks when you break out of an async flow by calling an outer callback. (#1064, #1542)
|
||||
- `during` and `doDuring` have been removed, and instead `whilst`, `doWhilst`, `until` and `doUntil` now have asynchronous `test` functions. (#850, #1557)
|
||||
- `limits` of less than 1 now cause an error to be thrown in queues and collection methods. (#1249, #1552)
|
||||
- `memoize` no longer memoizes errors (#1465, #1466)
|
||||
- `applyEach`/`applyEachSeries` have a simpler interface, to make them more easily type-able. It always returns a function that takes in a single callback argument. If that callback is omitted, a promise is returned, making it awaitable. (#1228, #1640)
|
||||
|
||||
## New Features
|
||||
- Async generators are now supported in all the Collection methods. (#1560)
|
||||
- Added `cargoQueue`, a queue with both `concurrency` and `payload` size parameters. (#1567)
|
||||
- Queue objects returned from `queue` now have a `Symbol.iterator` method, meaning they can be iterated over to inspect the current list of items in the queue. (#1459, #1556)
|
||||
- A ESM-flavored `async.mjs` is included in the `async` package. This is described in the `package.json` `"module"` field, meaning it should be automatically used by Webpack and other compatible bundlers.
|
||||
|
||||
## Bug fixes
|
||||
- Better handle arbitrary error objects in `asyncify` (#1568, #1569)
|
||||
|
||||
## Other
|
||||
- Removed Lodash as a dependency (#1283, #1528)
|
||||
- Miscellaneous docs fixes (#1393, #1501, #1540, #1543, #1558, #1563, #1564, #1579, #1581)
|
||||
- Miscellaneous test fixes (#1538)
|
||||
|
||||
-------
|
||||
|
||||
# v2.6.1
|
||||
- Updated lodash to prevent `npm audit` warnings. (#1532, #1533)
|
||||
- Made `async-es` more optimized for webpack users (#1517)
|
||||
- Fixed a stack overflow with large collections and a synchronous iterator (#1514)
|
||||
- Various small fixes/chores (#1505, #1511, #1527, #1530)
|
||||
|
||||
# v2.6.0
|
||||
- Added missing aliases for many methods. Previously, you could not (e.g.) `require('async/find')` or use `async.anyLimit`. (#1483)
|
||||
- Improved `queue` performance. (#1448, #1454)
|
||||
- Add missing sourcemap (#1452, #1453)
|
||||
- Various doc updates (#1448, #1471, #1483)
|
||||
|
||||
# v2.5.0
|
||||
- Added `concatLimit`, the `Limit` equivalent of [`concat`](https://caolan.github.io/async/docs.html#concat) ([#1426](https://github.com/caolan/async/issues/1426), [#1430](https://github.com/caolan/async/pull/1430))
|
||||
- `concat` improvements: it now preserves order, handles falsy values and the `iteratee` callback takes a variable number of arguments ([#1437](https://github.com/caolan/async/issues/1437), [#1436](https://github.com/caolan/async/pull/1436))
|
||||
- Fixed an issue in `queue` where there was a size discrepancy between `workersList().length` and `running()` ([#1428](https://github.com/caolan/async/issues/1428), [#1429](https://github.com/caolan/async/pull/1429))
|
||||
- Various doc fixes ([#1422](https://github.com/caolan/async/issues/1422), [#1424](https://github.com/caolan/async/pull/1424))
|
||||
|
||||
# v2.4.1
|
||||
- Fixed a bug preventing functions wrapped with `timeout()` from being re-used. ([#1418](https://github.com/caolan/async/issues/1418), [#1419](https://github.com/caolan/async/issues/1419))
|
||||
|
||||
# v2.4.0
|
||||
- Added `tryEach`, for running async functions in parallel, where you only expect one to succeed. ([#1365](https://github.com/caolan/async/issues/1365), [#687](https://github.com/caolan/async/issues/687))
|
||||
- Improved performance, most notably in `parallel` and `waterfall` ([#1395](https://github.com/caolan/async/issues/1395))
|
||||
- Added `queue.remove()`, for removing items in a `queue` ([#1397](https://github.com/caolan/async/issues/1397), [#1391](https://github.com/caolan/async/issues/1391))
|
||||
- Fixed using `eval`, preventing Async from running in pages with Content Security Policy ([#1404](https://github.com/caolan/async/issues/1404), [#1403](https://github.com/caolan/async/issues/1403))
|
||||
- Fixed errors thrown in an `asyncify`ed function's callback being caught by the underlying Promise ([#1408](https://github.com/caolan/async/issues/1408))
|
||||
- Fixed timing of `queue.empty()` ([#1367](https://github.com/caolan/async/issues/1367))
|
||||
- Various doc fixes ([#1314](https://github.com/caolan/async/issues/1314), [#1394](https://github.com/caolan/async/issues/1394), [#1412](https://github.com/caolan/async/issues/1412))
|
||||
|
||||
# v2.3.0
|
||||
- Added support for ES2017 `async` functions. Wherever you can pass a Node-style/CPS function that uses a callback, you can also pass an `async` function. Previously, you had to wrap `async` functions with `asyncify`. The caveat is that it will only work if `async` functions are supported natively in your environment, transpiled implementations can't be detected. ([#1386](https://github.com/caolan/async/issues/1386), [#1390](https://github.com/caolan/async/issues/1390))
|
||||
- Small doc fix ([#1392](https://github.com/caolan/async/issues/1392))
|
||||
|
||||
# v2.2.0
|
||||
- Added `groupBy`, and the `Series`/`Limit` equivalents, analogous to [`_.groupBy`](http://lodash.com/docs#groupBy) ([#1364](https://github.com/caolan/async/issues/1364))
|
||||
- Fixed `transform` bug when `callback` was not passed ([#1381](https://github.com/caolan/async/issues/1381))
|
||||
- Added note about `reflect` to `parallel` docs ([#1385](https://github.com/caolan/async/issues/1385))
|
||||
|
||||
# v2.1.5
|
||||
- Fix `auto` bug when function names collided with Array.prototype ([#1358](https://github.com/caolan/async/issues/1358))
|
||||
- Improve some error messages ([#1349](https://github.com/caolan/async/issues/1349))
|
||||
- Avoid stack overflow case in queue
|
||||
- Fixed an issue in `some`, `every` and `find` where processing would continue after the result was determined.
|
||||
- Cleanup implementations of `some`, `every` and `find`
|
||||
|
||||
# v2.1.3
|
||||
- Make bundle size smaller
|
||||
- Create optimized hotpath for `filter` in array case.
|
||||
|
||||
# v2.1.2
|
||||
- Fixed a stackoverflow bug with `detect`, `some`, `every` on large inputs ([#1293](https://github.com/caolan/async/issues/1293)).
|
||||
|
||||
# v2.1.0
|
||||
|
||||
- `retry` and `retryable` now support an optional `errorFilter` function that determines if the `task` should retry on the error ([#1256](https://github.com/caolan/async/issues/1256), [#1261](https://github.com/caolan/async/issues/1261))
|
||||
- Optimized array iteration in `race`, `cargo`, `queue`, and `priorityQueue` ([#1253](https://github.com/caolan/async/issues/1253))
|
||||
- Added alias documentation to doc site ([#1251](https://github.com/caolan/async/issues/1251), [#1254](https://github.com/caolan/async/issues/1254))
|
||||
- Added [BootStrap scrollspy](http://getbootstrap.com/javascript/#scrollspy) to docs to highlight in the sidebar the current method being viewed ([#1289](https://github.com/caolan/async/issues/1289), [#1300](https://github.com/caolan/async/issues/1300))
|
||||
- Various minor doc fixes ([#1263](https://github.com/caolan/async/issues/1263), [#1264](https://github.com/caolan/async/issues/1264), [#1271](https://github.com/caolan/async/issues/1271), [#1278](https://github.com/caolan/async/issues/1278), [#1280](https://github.com/caolan/async/issues/1280), [#1282](https://github.com/caolan/async/issues/1282), [#1302](https://github.com/caolan/async/issues/1302))
|
||||
|
||||
# v2.0.1
|
||||
|
||||
- Significantly optimized all iteration based collection methods such as `each`, `map`, `filter`, etc ([#1245](https://github.com/caolan/async/issues/1245), [#1246](https://github.com/caolan/async/issues/1246), [#1247](https://github.com/caolan/async/issues/1247)).
|
||||
|
||||
# v2.0.0
|
||||
|
||||
Lots of changes here!
|
||||
|
||||
First and foremost, we have a slick new [site for docs](https://caolan.github.io/async/). Special thanks to [**@hargasinski**](https://github.com/hargasinski) for his work converting our old docs to `jsdoc` format and implementing the new website. Also huge ups to [**@ivanseidel**](https://github.com/ivanseidel) for designing our new logo. It was a long process for both of these tasks, but I think these changes turned out extraordinary well.
|
||||
|
||||
The biggest feature is modularization. You can now `require("async/series")` to only require the `series` function. Every Async library function is available this way. You still can `require("async")` to require the entire library, like you could do before.
|
||||
|
||||
We also provide Async as a collection of ES2015 modules. You can now `import {each} from 'async-es'` or `import waterfall from 'async-es/waterfall'`. If you are using only a few Async functions, and are using a ES bundler such as Rollup, this can significantly lower your build size.
|
||||
|
||||
Major thanks to [**@Kikobeats**](github.com/Kikobeats), [**@aearly**](github.com/aearly) and [**@megawac**](github.com/megawac) for doing the majority of the modularization work, as well as [**@jdalton**](github.com/jdalton) and [**@Rich-Harris**](github.com/Rich-Harris) for advisory work on the general modularization strategy.
|
||||
|
||||
Another one of the general themes of the 2.0 release is standardization of what an "async" function is. We are now more strictly following the node-style continuation passing style. That is, an async function is a function that:
|
||||
|
||||
1. Takes a variable number of arguments
|
||||
2. The last argument is always a callback
|
||||
3. The callback can accept any number of arguments
|
||||
4. The first argument passed to the callback will be treated as an error result, if the argument is truthy
|
||||
5. Any number of result arguments can be passed after the "error" argument
|
||||
6. The callback is called once and exactly once, either on the same tick or later tick of the JavaScript event loop.
|
||||
|
||||
There were several cases where Async accepted some functions that did not strictly have these properties, most notably `auto`, `every`, `some`, `filter`, `reject` and `detect`.
|
||||
|
||||
Another theme is performance. We have eliminated internal deferrals in all cases where they make sense. For example, in `waterfall` and `auto`, there was a `setImmediate` between each task -- these deferrals have been removed. A `setImmediate` call can add up to 1ms of delay. This might not seem like a lot, but it can add up if you are using many Async functions in the course of processing a HTTP request, for example. Nearly all asynchronous functions that do I/O already have some sort of deferral built in, so the extra deferral is unnecessary. The trade-off of this change is removing our built-in stack-overflow defense. Many synchronous callback calls in series can quickly overflow the JS call stack. If you do have a function that is sometimes synchronous (calling its callback on the same tick), and are running into stack overflows, wrap it with `async.ensureAsync()`.
|
||||
|
||||
Another big performance win has been re-implementing `queue`, `cargo`, and `priorityQueue` with [doubly linked lists](https://en.wikipedia.org/wiki/Doubly_linked_list) instead of arrays. This has lead to queues being an order of [magnitude faster on large sets of tasks](https://github.com/caolan/async/pull/1205).
|
||||
|
||||
## New Features
|
||||
|
||||
- Async is now modularized. Individual functions can be `require()`d from the main package. (`require('async/auto')`) ([#984](https://github.com/caolan/async/issues/984), [#996](https://github.com/caolan/async/issues/996))
|
||||
- Async is also available as a collection of ES2015 modules in the new `async-es` package. (`import {forEachSeries} from 'async-es'`) ([#984](https://github.com/caolan/async/issues/984), [#996](https://github.com/caolan/async/issues/996))
|
||||
- Added `race`, analogous to `Promise.race()`. It will run an array of async tasks in parallel and will call its callback with the result of the first task to respond. ([#568](https://github.com/caolan/async/issues/568), [#1038](https://github.com/caolan/async/issues/1038))
|
||||
- Collection methods now accept ES2015 iterators. Maps, Sets, and anything that implements the iterator spec can now be passed directly to `each`, `map`, `parallel`, etc.. ([#579](https://github.com/caolan/async/issues/579), [#839](https://github.com/caolan/async/issues/839), [#1074](https://github.com/caolan/async/issues/1074))
|
||||
- Added `mapValues`, for mapping over the properties of an object and returning an object with the same keys. ([#1157](https://github.com/caolan/async/issues/1157), [#1177](https://github.com/caolan/async/issues/1177))
|
||||
- Added `timeout`, a wrapper for an async function that will make the task time-out after the specified time. ([#1007](https://github.com/caolan/async/issues/1007), [#1027](https://github.com/caolan/async/issues/1027))
|
||||
- Added `reflect` and `reflectAll`, analagous to [`Promise.reflect()`](http://bluebirdjs.com/docs/api/reflect.html), a wrapper for async tasks that always succeeds, by gathering results and errors into an object. ([#942](https://github.com/caolan/async/issues/942), [#1012](https://github.com/caolan/async/issues/1012), [#1095](https://github.com/caolan/async/issues/1095))
|
||||
- `constant` supports dynamic arguments -- it will now always use its last argument as the callback. ([#1016](https://github.com/caolan/async/issues/1016), [#1052](https://github.com/caolan/async/issues/1052))
|
||||
- `setImmediate` and `nextTick` now support arguments to partially apply to the deferred function, like the node-native versions do. ([#940](https://github.com/caolan/async/issues/940), [#1053](https://github.com/caolan/async/issues/1053))
|
||||
- `auto` now supports resolving cyclic dependencies using [Kahn's algorithm](https://en.wikipedia.org/wiki/Topological_sorting#Kahn.27s_algorithm) ([#1140](https://github.com/caolan/async/issues/1140)).
|
||||
- Added `autoInject`, a relative of `auto` that automatically spreads a task's dependencies as arguments to the task function. ([#608](https://github.com/caolan/async/issues/608), [#1055](https://github.com/caolan/async/issues/1055), [#1099](https://github.com/caolan/async/issues/1099), [#1100](https://github.com/caolan/async/issues/1100))
|
||||
- You can now limit the concurrency of `auto` tasks. ([#635](https://github.com/caolan/async/issues/635), [#637](https://github.com/caolan/async/issues/637))
|
||||
- Added `retryable`, a relative of `retry` that wraps an async function, making it retry when called. ([#1058](https://github.com/caolan/async/issues/1058))
|
||||
- `retry` now supports specifying a function that determines the next time interval, useful for exponential backoff, logging and other retry strategies. ([#1161](https://github.com/caolan/async/issues/1161))
|
||||
- `retry` will now pass all of the arguments the task function was resolved with to the callback ([#1231](https://github.com/caolan/async/issues/1231)).
|
||||
- Added `q.unsaturated` -- callback called when a `queue`'s number of running workers falls below a threshold. ([#868](https://github.com/caolan/async/issues/868), [#1030](https://github.com/caolan/async/issues/1030), [#1033](https://github.com/caolan/async/issues/1033), [#1034](https://github.com/caolan/async/issues/1034))
|
||||
- Added `q.error` -- a callback called whenever a `queue` task calls its callback with an error. ([#1170](https://github.com/caolan/async/issues/1170))
|
||||
- `applyEach` and `applyEachSeries` now pass results to the final callback. ([#1088](https://github.com/caolan/async/issues/1088))
|
||||
|
||||
## Breaking changes
|
||||
|
||||
- Calling a callback more than once is considered an error, and an error will be thrown. This had an explicit breaking change in `waterfall`. If you were relying on this behavior, you should more accurately represent your control flow as an event emitter or stream. ([#814](https://github.com/caolan/async/issues/814), [#815](https://github.com/caolan/async/issues/815), [#1048](https://github.com/caolan/async/issues/1048), [#1050](https://github.com/caolan/async/issues/1050))
|
||||
- `auto` task functions now always take the callback as the last argument. If a task has dependencies, the `results` object will be passed as the first argument. To migrate old task functions, wrap them with [`_.flip`](https://lodash.com/docs#flip) ([#1036](https://github.com/caolan/async/issues/1036), [#1042](https://github.com/caolan/async/issues/1042))
|
||||
- Internal `setImmediate` calls have been refactored away. This may make existing flows vulnerable to stack overflows if you use many synchronous functions in series. Use `ensureAsync` to work around this. ([#696](https://github.com/caolan/async/issues/696), [#704](https://github.com/caolan/async/issues/704), [#1049](https://github.com/caolan/async/issues/1049), [#1050](https://github.com/caolan/async/issues/1050))
|
||||
- `map` used to return an object when iterating over an object. `map` now always returns an array, like in other libraries. The previous object behavior has been split out into `mapValues`. ([#1157](https://github.com/caolan/async/issues/1157), [#1177](https://github.com/caolan/async/issues/1177))
|
||||
- `filter`, `reject`, `some`, `every`, `detect` and their families like `{METHOD}Series` and `{METHOD}Limit` now expect an error as the first callback argument, rather than just a simple boolean. Pass `null` as the first argument, or use `fs.access` instead of `fs.exists`. ([#118](https://github.com/caolan/async/issues/118), [#774](https://github.com/caolan/async/issues/774), [#1028](https://github.com/caolan/async/issues/1028), [#1041](https://github.com/caolan/async/issues/1041))
|
||||
- `{METHOD}` and `{METHOD}Series` are now implemented in terms of `{METHOD}Limit`. This is a major internal simplification, and is not expected to cause many problems, but it does subtly affect how functions execute internally. ([#778](https://github.com/caolan/async/issues/778), [#847](https://github.com/caolan/async/issues/847))
|
||||
- `retry`'s callback is now optional. Previously, omitting the callback would partially apply the function, meaning it could be passed directly as a task to `series` or `auto`. The partially applied "control-flow" behavior has been separated out into `retryable`. ([#1054](https://github.com/caolan/async/issues/1054), [#1058](https://github.com/caolan/async/issues/1058))
|
||||
- The test function for `whilst`, `until`, and `during` used to be passed non-error args from the iteratee function's callback, but this led to weirdness where the first call of the test function would be passed no args. We have made it so the test function is never passed extra arguments, and only the `doWhilst`, `doUntil`, and `doDuring` functions pass iteratee callback arguments to the test function ([#1217](https://github.com/caolan/async/issues/1217), [#1224](https://github.com/caolan/async/issues/1224))
|
||||
- The `q.tasks` array has been renamed `q._tasks` and is now implemented as a doubly linked list (DLL). Any code that used to interact with this array will need to be updated to either use the provided helpers or support DLLs ([#1205](https://github.com/caolan/async/issues/1205)).
|
||||
- The timing of the `q.saturated()` callback in a `queue` has been modified to better reflect when tasks pushed to the queue will start queueing. ([#724](https://github.com/caolan/async/issues/724), [#1078](https://github.com/caolan/async/issues/1078))
|
||||
- Removed `iterator` method in favour of [ES2015 iterator protocol](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Iterators_and_Generators ) which natively supports arrays ([#1237](https://github.com/caolan/async/issues/1237))
|
||||
- Dropped support for Component, Jam, SPM, and Volo ([#1175](https://github.com/caolan/async/issues/1175), #[#176](https://github.com/caolan/async/issues/176))
|
||||
|
||||
## Bug Fixes
|
||||
|
||||
- Improved handling of no dependency cases in `auto` & `autoInject` ([#1147](https://github.com/caolan/async/issues/1147)).
|
||||
- Fixed a bug where the callback generated by `asyncify` with `Promises` could resolve twice ([#1197](https://github.com/caolan/async/issues/1197)).
|
||||
- Fixed several documented optional callbacks not actually being optional ([#1223](https://github.com/caolan/async/issues/1223)).
|
||||
|
||||
## Other
|
||||
|
||||
- Added `someSeries` and `everySeries` for symmetry, as well as a complete set of `any`/`anyLimit`/`anySeries` and `all`/`/allLmit`/`allSeries` aliases.
|
||||
- Added `find` as an alias for `detect. (as well as `findLimit` and `findSeries`).
|
||||
- Various doc fixes ([#1005](https://github.com/caolan/async/issues/1005), [#1008](https://github.com/caolan/async/issues/1008), [#1010](https://github.com/caolan/async/issues/1010), [#1015](https://github.com/caolan/async/issues/1015), [#1021](https://github.com/caolan/async/issues/1021), [#1037](https://github.com/caolan/async/issues/1037), [#1039](https://github.com/caolan/async/issues/1039), [#1051](https://github.com/caolan/async/issues/1051), [#1102](https://github.com/caolan/async/issues/1102), [#1107](https://github.com/caolan/async/issues/1107), [#1121](https://github.com/caolan/async/issues/1121), [#1123](https://github.com/caolan/async/issues/1123), [#1129](https://github.com/caolan/async/issues/1129), [#1135](https://github.com/caolan/async/issues/1135), [#1138](https://github.com/caolan/async/issues/1138), [#1141](https://github.com/caolan/async/issues/1141), [#1153](https://github.com/caolan/async/issues/1153), [#1216](https://github.com/caolan/async/issues/1216), [#1217](https://github.com/caolan/async/issues/1217), [#1232](https://github.com/caolan/async/issues/1232), [#1233](https://github.com/caolan/async/issues/1233), [#1236](https://github.com/caolan/async/issues/1236), [#1238](https://github.com/caolan/async/issues/1238))
|
||||
|
||||
Thank you [**@aearly**](github.com/aearly) and [**@megawac**](github.com/megawac) for taking the lead on version 2 of async.
|
||||
|
||||
------------------------------------------
|
||||
|
||||
# v1.5.2
|
||||
- Allow using `"constructor"` as an argument in `memoize` ([#998](https://github.com/caolan/async/issues/998))
|
||||
- Give a better error messsage when `auto` dependency checking fails ([#994](https://github.com/caolan/async/issues/994))
|
||||
- Various doc updates ([#936](https://github.com/caolan/async/issues/936), [#956](https://github.com/caolan/async/issues/956), [#979](https://github.com/caolan/async/issues/979), [#1002](https://github.com/caolan/async/issues/1002))
|
||||
|
||||
# v1.5.1
|
||||
- Fix issue with `pause` in `queue` with concurrency enabled ([#946](https://github.com/caolan/async/issues/946))
|
||||
- `while` and `until` now pass the final result to callback ([#963](https://github.com/caolan/async/issues/963))
|
||||
- `auto` will properly handle concurrency when there is no callback ([#966](https://github.com/caolan/async/issues/966))
|
||||
- `auto` will no. properly stop execution when an error occurs ([#988](https://github.com/caolan/async/issues/988), [#993](https://github.com/caolan/async/issues/993))
|
||||
- Various doc fixes ([#971](https://github.com/caolan/async/issues/971), [#980](https://github.com/caolan/async/issues/980))
|
||||
|
||||
# v1.5.0
|
||||
|
||||
- Added `transform`, analogous to [`_.transform`](http://lodash.com/docs#transform) ([#892](https://github.com/caolan/async/issues/892))
|
||||
- `map` now returns an object when an object is passed in, rather than array with non-numeric keys. `map` will begin always returning an array with numeric indexes in the next major release. ([#873](https://github.com/caolan/async/issues/873))
|
||||
- `auto` now accepts an optional `concurrency` argument to limit the number o. running tasks ([#637](https://github.com/caolan/async/issues/637))
|
||||
- Added `queue#workersList()`, to retrieve the lis. of currently running tasks. ([#891](https://github.com/caolan/async/issues/891))
|
||||
- Various code simplifications ([#896](https://github.com/caolan/async/issues/896), [#904](https://github.com/caolan/async/issues/904))
|
||||
- Various doc fixes :scroll: ([#890](https://github.com/caolan/async/issues/890), [#894](https://github.com/caolan/async/issues/894), [#903](https://github.com/caolan/async/issues/903), [#905](https://github.com/caolan/async/issues/905), [#912](https://github.com/caolan/async/issues/912))
|
||||
|
||||
# v1.4.2
|
||||
|
||||
- Ensure coverage files don't get published on npm ([#879](https://github.com/caolan/async/issues/879))
|
||||
|
||||
# v1.4.1
|
||||
|
||||
- Add in overlooked `detectLimit` method ([#866](https://github.com/caolan/async/issues/866))
|
||||
- Removed unnecessary files from npm releases ([#861](https://github.com/caolan/async/issues/861))
|
||||
- Removed usage of a reserved word to prevent :boom: in older environments ([#870](https://github.com/caolan/async/issues/870))
|
||||
|
||||
# v1.4.0
|
||||
|
||||
- `asyncify` now supports promises ([#840](https://github.com/caolan/async/issues/840))
|
||||
- Added `Limit` versions of `filter` and `reject` ([#836](https://github.com/caolan/async/issues/836))
|
||||
- Add `Limit` versions of `detect`, `some` and `every` ([#828](https://github.com/caolan/async/issues/828), [#829](https://github.com/caolan/async/issues/829))
|
||||
- `some`, `every` and `detect` now short circuit early ([#828](https://github.com/caolan/async/issues/828), [#829](https://github.com/caolan/async/issues/829))
|
||||
- Improve detection of the global object ([#804](https://github.com/caolan/async/issues/804)), enabling use in WebWorkers
|
||||
- `whilst` now called with arguments from iterator ([#823](https://github.com/caolan/async/issues/823))
|
||||
- `during` now gets called with arguments from iterator ([#824](https://github.com/caolan/async/issues/824))
|
||||
- Code simplifications and optimizations aplenty ([diff](https://github.com/caolan/async/compare/v1.3.0...v1.4.0))
|
||||
|
||||
|
||||
# v1.3.0
|
||||
|
||||
New Features:
|
||||
- Added `constant`
|
||||
- Added `asyncify`/`wrapSync` for making sync functions work with callbacks. ([#671](https://github.com/caolan/async/issues/671), [#806](https://github.com/caolan/async/issues/806))
|
||||
- Added `during` and `doDuring`, which are like `whilst` with an async truth test. ([#800](https://github.com/caolan/async/issues/800))
|
||||
- `retry` now accepts an `interval` parameter to specify a delay between retries. ([#793](https://github.com/caolan/async/issues/793))
|
||||
- `async` should work better in Web Workers due to better `root` detection ([#804](https://github.com/caolan/async/issues/804))
|
||||
- Callbacks are now optional in `whilst`, `doWhilst`, `until`, and `doUntil` ([#642](https://github.com/caolan/async/issues/642))
|
||||
- Various internal updates ([#786](https://github.com/caolan/async/issues/786), [#801](https://github.com/caolan/async/issues/801), [#802](https://github.com/caolan/async/issues/802), [#803](https://github.com/caolan/async/issues/803))
|
||||
- Various doc fixes ([#790](https://github.com/caolan/async/issues/790), [#794](https://github.com/caolan/async/issues/794))
|
||||
|
||||
Bug Fixes:
|
||||
- `cargo` now exposes the `payload` size, and `cargo.payload` can be changed on the fly after the `cargo` is created. ([#740](https://github.com/caolan/async/issues/740), [#744](https://github.com/caolan/async/issues/744), [#783](https://github.com/caolan/async/issues/783))
|
||||
|
||||
|
||||
# v1.2.1
|
||||
|
||||
Bug Fix:
|
||||
|
||||
- Small regression with synchronous iterator behavior in `eachSeries` with a 1-element array. Before 1.1.0, `eachSeries`'s callback was called on the same tick, which this patch restores. In 2.0.0, it will be called on the next tick. ([#782](https://github.com/caolan/async/issues/782))
|
||||
|
||||
|
||||
# v1.2.0
|
||||
|
||||
New Features:
|
||||
|
||||
- Added `timesLimit` ([#743](https://github.com/caolan/async/issues/743))
|
||||
- `concurrency` can be changed after initialization in `queue` by setting `q.concurrency`. The new concurrency will be reflected the next time a task is processed. ([#747](https://github.com/caolan/async/issues/747), [#772](https://github.com/caolan/async/issues/772))
|
||||
|
||||
Bug Fixes:
|
||||
|
||||
- Fixed a regression in `each` and family with empty arrays that have additional properties. ([#775](https://github.com/caolan/async/issues/775), [#777](https://github.com/caolan/async/issues/777))
|
||||
|
||||
|
||||
# v1.1.1
|
||||
|
||||
Bug Fix:
|
||||
|
||||
- Small regression with synchronous iterator behavior in `eachSeries` with a 1-element array. Before 1.1.0, `eachSeries`'s callback was called on the same tick, which this patch restores. In 2.0.0, it will be called on the next tick. ([#782](https://github.com/caolan/async/issues/782))
|
||||
|
||||
|
||||
# v1.1.0
|
||||
|
||||
New Features:
|
||||
|
||||
- `cargo` now supports all of the same methods and event callbacks as `queue`.
|
||||
- Added `ensureAsync` - A wrapper that ensures an async function calls its callback on a later tick. ([#769](https://github.com/caolan/async/issues/769))
|
||||
- Optimized `map`, `eachOf`, and `waterfall` families of functions
|
||||
- Passing a `null` or `undefined` array to `map`, `each`, `parallel` and families will be treated as an empty array ([#667](https://github.com/caolan/async/issues/667)).
|
||||
- The callback is now optional for the composed results of `compose` and `seq`. ([#618](https://github.com/caolan/async/issues/618))
|
||||
- Reduced file size by 4kb, (minified version by 1kb)
|
||||
- Added code coverage through `nyc` and `coveralls` ([#768](https://github.com/caolan/async/issues/768))
|
||||
|
||||
Bug Fixes:
|
||||
|
||||
- `forever` will no longer stack overflow with a synchronous iterator ([#622](https://github.com/caolan/async/issues/622))
|
||||
- `eachLimit` and other limit functions will stop iterating once an error occurs ([#754](https://github.com/caolan/async/issues/754))
|
||||
- Always pass `null` in callbacks when there is no error ([#439](https://github.com/caolan/async/issues/439))
|
||||
- Ensure proper conditions when calling `drain()` after pushing an empty data set to a queue ([#668](https://github.com/caolan/async/issues/668))
|
||||
- `each` and family will properly handle an empty array ([#578](https://github.com/caolan/async/issues/578))
|
||||
- `eachSeries` and family will finish if the underlying array is modified during execution ([#557](https://github.com/caolan/async/issues/557))
|
||||
- `queue` will throw if a non-function is passed to `q.push()` ([#593](https://github.com/caolan/async/issues/593))
|
||||
- Doc fixes ([#629](https://github.com/caolan/async/issues/629), [#766](https://github.com/caolan/async/issues/766))
|
||||
|
||||
|
||||
# v1.0.0
|
||||
|
||||
No known breaking changes, we are simply complying with semver from here on out.
|
||||
|
||||
Changes:
|
||||
|
||||
- Start using a changelog!
|
||||
- Add `forEachOf` for iterating over Objects (or to iterate Arrays with indexes available) ([#168](https://github.com/caolan/async/issues/168) [#704](https://github.com/caolan/async/issues/704) [#321](https://github.com/caolan/async/issues/321))
|
||||
- Detect deadlocks in `auto` ([#663](https://github.com/caolan/async/issues/663))
|
||||
- Better support for require.js ([#527](https://github.com/caolan/async/issues/527))
|
||||
- Throw if queue created with concurrency `0` ([#714](https://github.com/caolan/async/issues/714))
|
||||
- Fix unneeded iteration in `queue.resume()` ([#758](https://github.com/caolan/async/issues/758))
|
||||
- Guard against timer mocking overriding `setImmediate` ([#609](https://github.com/caolan/async/issues/609) [#611](https://github.com/caolan/async/issues/611))
|
||||
- Miscellaneous doc fixes ([#542](https://github.com/caolan/async/issues/542) [#596](https://github.com/caolan/async/issues/596) [#615](https://github.com/caolan/async/issues/615) [#628](https://github.com/caolan/async/issues/628) [#631](https://github.com/caolan/async/issues/631) [#690](https://github.com/caolan/async/issues/690) [#729](https://github.com/caolan/async/issues/729))
|
||||
- Use single noop function internally ([#546](https://github.com/caolan/async/issues/546))
|
||||
- Optimize internal `_each`, `_map` and `_keys` functions.
|
||||
|
|
@ -1,19 +0,0 @@
|
|||
Copyright (c) 2010-2018 Caolan McMahon
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in
|
||||
all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||
THE SOFTWARE.
|
||||
|
|
@ -1,59 +0,0 @@
|
|||
|
||||
|
||||
|
||||
[](https://www.npmjs.com/package/async)
|
||||
[](https://coveralls.io/r/caolan/async?branch=master)
|
||||
[](https://gitter.im/caolan/async?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
||||
[](https://www.jsdelivr.com/package/npm/async)
|
||||
|
||||
<!--
|
||||
|Linux|Windows|MacOS|
|
||||
|-|-|-|
|
||||
|[](https://dev.azure.com/caolanmcmahon/async/_build/latest?definitionId=1&branchName=master) | [](https://dev.azure.com/caolanmcmahon/async/_build/latest?definitionId=1&branchName=master) | [](https://dev.azure.com/caolanmcmahon/async/_build/latest?definitionId=1&branchName=master)| -->
|
||||
|
||||
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. A ESM/MJS version is included in the main `async` package that should automatically be used with compatible bundlers such as Webpack and Rollup.
|
||||
|
||||
A pure ESM version of Async is available as [`async-es`](https://www.npmjs.com/package/async-es).
|
||||
|
||||
For Documentation, visit <https://caolan.github.io/async/>
|
||||
|
||||
*For Async v1.5.x documentation, go [HERE](https://github.com/caolan/async/blob/v1.5.2/README.md)*
|
||||
|
||||
|
||||
```javascript
|
||||
// for use with Node-style callbacks...
|
||||
var async = require("async");
|
||||
|
||||
var obj = {dev: "/dev.json", test: "/test.json", prod: "/prod.json"};
|
||||
var configs = {};
|
||||
|
||||
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();
|
||||
});
|
||||
}, err => {
|
||||
if (err) console.error(err.message);
|
||||
// configs is now a map of JSON data
|
||||
doSomethingWith(configs);
|
||||
});
|
||||
```
|
||||
|
||||
```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)
|
||||
})
|
||||
```
|
||||
|
|
@ -1,119 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOf = require('./eachOf.js');
|
||||
|
||||
var _eachOf2 = _interopRequireDefault(_eachOf);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Returns `true` if every element in `coll` satisfies an async test. If any
|
||||
* iteratee call returns `false`, the main `callback` is immediately called.
|
||||
*
|
||||
* @name every
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias all
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async truth test to apply to each item
|
||||
* in the collection in parallel.
|
||||
* The iteratee must complete with a boolean result value.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Result will be either `true` or `false`
|
||||
* depending on the values of the async tests. Invoked with (err, result).
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
* @example
|
||||
*
|
||||
* // dir1 is a directory that contains file1.txt, file2.txt
|
||||
* // dir2 is a directory that contains file3.txt, file4.txt
|
||||
* // dir3 is a directory that contains file5.txt
|
||||
* // dir4 does not exist
|
||||
*
|
||||
* const fileList = ['dir1/file1.txt','dir2/file3.txt','dir3/file5.txt'];
|
||||
* const withMissingFileList = ['file1.txt','file2.txt','file4.txt'];
|
||||
*
|
||||
* // asynchronous function that checks if a file exists
|
||||
* function fileExists(file, callback) {
|
||||
* fs.access(file, fs.constants.F_OK, (err) => {
|
||||
* callback(null, !err);
|
||||
* });
|
||||
* }
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.every(fileList, fileExists, function(err, result) {
|
||||
* console.log(result);
|
||||
* // true
|
||||
* // result is true since every file exists
|
||||
* });
|
||||
*
|
||||
* async.every(withMissingFileList, fileExists, function(err, result) {
|
||||
* console.log(result);
|
||||
* // false
|
||||
* // result is false since NOT every file exists
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.every(fileList, fileExists)
|
||||
* .then( result => {
|
||||
* console.log(result);
|
||||
* // true
|
||||
* // result is true since every file exists
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* async.every(withMissingFileList, fileExists)
|
||||
* .then( result => {
|
||||
* console.log(result);
|
||||
* // false
|
||||
* // result is false since NOT every file exists
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.every(fileList, fileExists);
|
||||
* console.log(result);
|
||||
* // true
|
||||
* // result is true since every file exists
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.every(withMissingFileList, fileExists);
|
||||
* console.log(result);
|
||||
* // false
|
||||
* // result is false since NOT every file exists
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function every(coll, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => !bool, res => !res)(_eachOf2.default, coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(every, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,46 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOfLimit = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`every`]{@link module:Collections.every} but runs a maximum of `limit` async operations at a time.
|
||||
*
|
||||
* @name everyLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.every]{@link module:Collections.every}
|
||||
* @alias allLimit
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - An async truth test to apply to each item
|
||||
* in the collection in parallel.
|
||||
* The iteratee must complete with a boolean result value.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Result will be either `true` or `false`
|
||||
* depending on the values of the async tests. Invoked with (err, result).
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
*/
|
||||
function everyLimit(coll, limit, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => !bool, res => !res)((0, _eachOfLimit2.default)(limit), coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(everyLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,45 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOfSeries = require('./eachOfSeries.js');
|
||||
|
||||
var _eachOfSeries2 = _interopRequireDefault(_eachOfSeries);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`every`]{@link module:Collections.every} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name everySeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.every]{@link module:Collections.every}
|
||||
* @alias allSeries
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async truth test to apply to each item
|
||||
* in the collection in series.
|
||||
* The iteratee must complete with a boolean result value.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Result will be either `true` or `false`
|
||||
* depending on the values of the async tests. Invoked with (err, result).
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
*/
|
||||
function everySeries(coll, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => !bool, res => !res)(_eachOfSeries2.default, coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(everySeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,122 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOf = require('./eachOf.js');
|
||||
|
||||
var _eachOf2 = _interopRequireDefault(_eachOf);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Returns `true` if at least one element in the `coll` satisfies an async test.
|
||||
* If any iteratee call returns `true`, the main `callback` is immediately
|
||||
* called.
|
||||
*
|
||||
* @name some
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias any
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async truth test to apply to each item
|
||||
* in the collections in parallel.
|
||||
* The iteratee should complete with a boolean `result` value.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called as soon as any
|
||||
* iteratee returns `true`, or after all the iteratee functions have finished.
|
||||
* Result will be either `true` or `false` depending on the values of the async
|
||||
* tests. Invoked with (err, result).
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
* @example
|
||||
*
|
||||
* // dir1 is a directory that contains file1.txt, file2.txt
|
||||
* // dir2 is a directory that contains file3.txt, file4.txt
|
||||
* // dir3 is a directory that contains file5.txt
|
||||
* // dir4 does not exist
|
||||
*
|
||||
* // asynchronous function that checks if a file exists
|
||||
* function fileExists(file, callback) {
|
||||
* fs.access(file, fs.constants.F_OK, (err) => {
|
||||
* callback(null, !err);
|
||||
* });
|
||||
* }
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.some(['dir1/missing.txt','dir2/missing.txt','dir3/file5.txt'], fileExists,
|
||||
* function(err, result) {
|
||||
* console.log(result);
|
||||
* // true
|
||||
* // result is true since some file in the list exists
|
||||
* }
|
||||
*);
|
||||
*
|
||||
* async.some(['dir1/missing.txt','dir2/missing.txt','dir4/missing.txt'], fileExists,
|
||||
* function(err, result) {
|
||||
* console.log(result);
|
||||
* // false
|
||||
* // result is false since none of the files exists
|
||||
* }
|
||||
*);
|
||||
*
|
||||
* // Using Promises
|
||||
* async.some(['dir1/missing.txt','dir2/missing.txt','dir3/file5.txt'], fileExists)
|
||||
* .then( result => {
|
||||
* console.log(result);
|
||||
* // true
|
||||
* // result is true since some file in the list exists
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* async.some(['dir1/missing.txt','dir2/missing.txt','dir4/missing.txt'], fileExists)
|
||||
* .then( result => {
|
||||
* console.log(result);
|
||||
* // false
|
||||
* // result is false since none of the files exists
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.some(['dir1/missing.txt','dir2/missing.txt','dir3/file5.txt'], fileExists);
|
||||
* console.log(result);
|
||||
* // true
|
||||
* // result is true since some file in the list exists
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.some(['dir1/missing.txt','dir2/missing.txt','dir4/missing.txt'], fileExists);
|
||||
* console.log(result);
|
||||
* // false
|
||||
* // result is false since none of the files exists
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function some(coll, iteratee, callback) {
|
||||
return (0, _createTester2.default)(Boolean, res => res)(_eachOf2.default, coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(some, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,47 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOfLimit = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`some`]{@link module:Collections.some} but runs a maximum of `limit` async operations at a time.
|
||||
*
|
||||
* @name someLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.some]{@link module:Collections.some}
|
||||
* @alias anyLimit
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - An async truth test to apply to each item
|
||||
* in the collections in parallel.
|
||||
* The iteratee should complete with a boolean `result` value.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called as soon as any
|
||||
* iteratee returns `true`, or after all the iteratee functions have finished.
|
||||
* Result will be either `true` or `false` depending on the values of the async
|
||||
* tests. Invoked with (err, result).
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
*/
|
||||
function someLimit(coll, limit, iteratee, callback) {
|
||||
return (0, _createTester2.default)(Boolean, res => res)((0, _eachOfLimit2.default)(limit), coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(someLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,46 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOfSeries = require('./eachOfSeries.js');
|
||||
|
||||
var _eachOfSeries2 = _interopRequireDefault(_eachOfSeries);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`some`]{@link module:Collections.some} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name someSeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.some]{@link module:Collections.some}
|
||||
* @alias anySeries
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async truth test to apply to each item
|
||||
* in the collections in series.
|
||||
* The iteratee should complete with a boolean `result` value.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called as soon as any
|
||||
* iteratee returns `true`, or after all the iteratee functions have finished.
|
||||
* Result will be either `true` or `false` depending on the values of the async
|
||||
* tests. Invoked with (err, result).
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
*/
|
||||
function someSeries(coll, iteratee, callback) {
|
||||
return (0, _createTester2.default)(Boolean, res => res)(_eachOfSeries2.default, coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(someSeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,55 +0,0 @@
|
|||
"use strict";
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
exports.default = function (fn, ...args) {
|
||||
return (...callArgs) => fn(...args, ...callArgs);
|
||||
};
|
||||
|
||||
module.exports = exports["default"]; /**
|
||||
* Creates a continuation function with some arguments already applied.
|
||||
*
|
||||
* Useful as a shorthand when combined with other control flow functions. Any
|
||||
* arguments passed to the returned function are added to the arguments
|
||||
* originally passed to apply.
|
||||
*
|
||||
* @name apply
|
||||
* @static
|
||||
* @memberOf module:Utils
|
||||
* @method
|
||||
* @category Util
|
||||
* @param {Function} fn - The function you want to eventually apply all
|
||||
* arguments to. Invokes with (arguments...).
|
||||
* @param {...*} arguments... - Any number of arguments to automatically apply
|
||||
* when the continuation is called.
|
||||
* @returns {Function} the partially-applied function
|
||||
* @example
|
||||
*
|
||||
* // using apply
|
||||
* async.parallel([
|
||||
* async.apply(fs.writeFile, 'testfile1', 'test1'),
|
||||
* async.apply(fs.writeFile, 'testfile2', 'test2')
|
||||
* ]);
|
||||
*
|
||||
*
|
||||
* // the same process without using apply
|
||||
* async.parallel([
|
||||
* function(callback) {
|
||||
* fs.writeFile('testfile1', 'test1', callback);
|
||||
* },
|
||||
* function(callback) {
|
||||
* fs.writeFile('testfile2', 'test2', callback);
|
||||
* }
|
||||
* ]);
|
||||
*
|
||||
* // It's possible to pass any number of additional arguments when calling the
|
||||
* // continuation:
|
||||
*
|
||||
* node> var fn = async.apply(sys.puts, 'one');
|
||||
* node> fn('two', 'three');
|
||||
* one
|
||||
* two
|
||||
* three
|
||||
*/
|
||||
|
|
@ -1,57 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _applyEach = require('./internal/applyEach.js');
|
||||
|
||||
var _applyEach2 = _interopRequireDefault(_applyEach);
|
||||
|
||||
var _map = require('./map.js');
|
||||
|
||||
var _map2 = _interopRequireDefault(_map);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Applies the provided arguments to each function in the array, calling
|
||||
* `callback` after all functions have completed. If you only provide the first
|
||||
* argument, `fns`, then it will return a function which lets you pass in the
|
||||
* arguments as if it were a single function call. If more arguments are
|
||||
* provided, `callback` is required while `args` is still optional. The results
|
||||
* for each of the applied async functions are passed to the final callback
|
||||
* as an array.
|
||||
*
|
||||
* @name applyEach
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @category Control Flow
|
||||
* @param {Array|Iterable|AsyncIterable|Object} fns - A collection of {@link AsyncFunction}s
|
||||
* to all call with the same arguments
|
||||
* @param {...*} [args] - any number of separate arguments to pass to the
|
||||
* function.
|
||||
* @param {Function} [callback] - the final argument should be the callback,
|
||||
* called when all functions have completed processing.
|
||||
* @returns {AsyncFunction} - Returns a function that takes no args other than
|
||||
* an optional callback, that is the result of applying the `args` to each
|
||||
* of the functions.
|
||||
* @example
|
||||
*
|
||||
* const appliedFn = async.applyEach([enableSearch, updateSchema], 'bucket')
|
||||
*
|
||||
* appliedFn((err, results) => {
|
||||
* // results[0] is the results for `enableSearch`
|
||||
* // results[1] is the results for `updateSchema`
|
||||
* });
|
||||
*
|
||||
* // partial application example:
|
||||
* async.each(
|
||||
* buckets,
|
||||
* async (bucket) => async.applyEach([enableSearch, updateSchema], bucket)(),
|
||||
* callback
|
||||
* );
|
||||
*/
|
||||
exports.default = (0, _applyEach2.default)(_map2.default);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,37 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _applyEach = require('./internal/applyEach.js');
|
||||
|
||||
var _applyEach2 = _interopRequireDefault(_applyEach);
|
||||
|
||||
var _mapSeries = require('./mapSeries.js');
|
||||
|
||||
var _mapSeries2 = _interopRequireDefault(_mapSeries);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`applyEach`]{@link module:ControlFlow.applyEach} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name applyEachSeries
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @see [async.applyEach]{@link module:ControlFlow.applyEach}
|
||||
* @category Control Flow
|
||||
* @param {Array|Iterable|AsyncIterable|Object} fns - A collection of {@link AsyncFunction}s to all
|
||||
* call with the same arguments
|
||||
* @param {...*} [args] - any number of separate arguments to pass to the
|
||||
* function.
|
||||
* @param {Function} [callback] - the final argument should be the callback,
|
||||
* called when all functions have completed processing.
|
||||
* @returns {AsyncFunction} - A function, that when called, is the result of
|
||||
* appling the `args` to the list of functions. It takes no args, other than
|
||||
* a callback.
|
||||
*/
|
||||
exports.default = (0, _applyEach2.default)(_mapSeries2.default);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,118 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = asyncify;
|
||||
|
||||
var _initialParams = require('./internal/initialParams.js');
|
||||
|
||||
var _initialParams2 = _interopRequireDefault(_initialParams);
|
||||
|
||||
var _setImmediate = require('./internal/setImmediate.js');
|
||||
|
||||
var _setImmediate2 = _interopRequireDefault(_setImmediate);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Take a sync function and make it async, passing its return value to a
|
||||
* callback. This is useful for plugging sync functions into a waterfall,
|
||||
* series, or other async functions. Any arguments passed to the generated
|
||||
* function will be passed to the wrapped function (except for the final
|
||||
* callback argument). Errors thrown will be passed to the callback.
|
||||
*
|
||||
* If the function passed to `asyncify` returns a Promise, that promises's
|
||||
* resolved/rejected state will be used to call the callback, rather than simply
|
||||
* the synchronous return value.
|
||||
*
|
||||
* This also means you can asyncify ES2017 `async` functions.
|
||||
*
|
||||
* @name asyncify
|
||||
* @static
|
||||
* @memberOf module:Utils
|
||||
* @method
|
||||
* @alias wrapSync
|
||||
* @category Util
|
||||
* @param {Function} func - The synchronous function, or Promise-returning
|
||||
* function to convert to an {@link AsyncFunction}.
|
||||
* @returns {AsyncFunction} An asynchronous wrapper of the `func`. To be
|
||||
* invoked with `(args..., callback)`.
|
||||
* @example
|
||||
*
|
||||
* // passing a regular synchronous function
|
||||
* async.waterfall([
|
||||
* async.apply(fs.readFile, filename, "utf8"),
|
||||
* async.asyncify(JSON.parse),
|
||||
* function (data, next) {
|
||||
* // data is the result of parsing the text.
|
||||
* // If there was a parsing error, it would have been caught.
|
||||
* }
|
||||
* ], callback);
|
||||
*
|
||||
* // passing a function returning a promise
|
||||
* async.waterfall([
|
||||
* async.apply(fs.readFile, filename, "utf8"),
|
||||
* async.asyncify(function (contents) {
|
||||
* return db.model.create(contents);
|
||||
* }),
|
||||
* function (model, next) {
|
||||
* // `model` is the instantiated model object.
|
||||
* // If there was an error, this function would be skipped.
|
||||
* }
|
||||
* ], callback);
|
||||
*
|
||||
* // es2017 example, though `asyncify` is not needed if your JS environment
|
||||
* // supports async functions out of the box
|
||||
* var q = async.queue(async.asyncify(async function(file) {
|
||||
* var intermediateStep = await processFile(file);
|
||||
* return await somePromise(intermediateStep)
|
||||
* }));
|
||||
*
|
||||
* q.push(files);
|
||||
*/
|
||||
function asyncify(func) {
|
||||
if ((0, _wrapAsync.isAsync)(func)) {
|
||||
return function (...args /*, callback*/) {
|
||||
const callback = args.pop();
|
||||
const promise = func.apply(this, args);
|
||||
return handlePromise(promise, callback);
|
||||
};
|
||||
}
|
||||
|
||||
return (0, _initialParams2.default)(function (args, callback) {
|
||||
var result;
|
||||
try {
|
||||
result = func.apply(this, args);
|
||||
} catch (e) {
|
||||
return callback(e);
|
||||
}
|
||||
// if result is Promise object
|
||||
if (result && typeof result.then === 'function') {
|
||||
return handlePromise(result, callback);
|
||||
} else {
|
||||
callback(null, result);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
function handlePromise(promise, callback) {
|
||||
return promise.then(value => {
|
||||
invokeCallback(callback, null, value);
|
||||
}, err => {
|
||||
invokeCallback(callback, err && err.message ? err : new Error(err));
|
||||
});
|
||||
}
|
||||
|
||||
function invokeCallback(callback, error, value) {
|
||||
try {
|
||||
callback(error, value);
|
||||
} catch (err) {
|
||||
(0, _setImmediate2.default)(e => {
|
||||
throw e;
|
||||
}, err);
|
||||
}
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,333 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = auto;
|
||||
|
||||
var _once = require('./internal/once.js');
|
||||
|
||||
var _once2 = _interopRequireDefault(_once);
|
||||
|
||||
var _onlyOnce = require('./internal/onlyOnce.js');
|
||||
|
||||
var _onlyOnce2 = _interopRequireDefault(_onlyOnce);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _promiseCallback = require('./internal/promiseCallback.js');
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Determines the best order for running the {@link AsyncFunction}s in `tasks`, based on
|
||||
* their requirements. Each function can optionally depend on other functions
|
||||
* being completed first, and each function is run as soon as its requirements
|
||||
* are satisfied.
|
||||
*
|
||||
* If any of the {@link AsyncFunction}s pass an error to their callback, the `auto` sequence
|
||||
* will stop. Further tasks will not execute (so any other functions depending
|
||||
* on it will not run), and the main `callback` is immediately called with the
|
||||
* error.
|
||||
*
|
||||
* {@link AsyncFunction}s also receive an object containing the results of functions which
|
||||
* have completed so far as the first argument, if they have dependencies. If a
|
||||
* task function has no dependencies, it will only be passed a callback.
|
||||
*
|
||||
* @name auto
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @category Control Flow
|
||||
* @param {Object} tasks - An object. Each of its properties is either a
|
||||
* function or an array of requirements, with the {@link AsyncFunction} itself the last item
|
||||
* in the array. The object's key of a property serves as the name of the task
|
||||
* defined by that property, i.e. can be used when specifying requirements for
|
||||
* other tasks. The function receives one or two arguments:
|
||||
* * a `results` object, containing the results of the previously executed
|
||||
* functions, only passed if the task has any dependencies,
|
||||
* * a `callback(err, result)` function, which must be called when finished,
|
||||
* passing an `error` (which can be `null`) and the result of the function's
|
||||
* execution.
|
||||
* @param {number} [concurrency=Infinity] - An optional `integer` for
|
||||
* determining the maximum number of tasks that can be run in parallel. By
|
||||
* default, as many as possible.
|
||||
* @param {Function} [callback] - An optional callback which is called when all
|
||||
* the tasks have been completed. It receives the `err` argument if any `tasks`
|
||||
* pass an error to their callback. Results are always returned; however, if an
|
||||
* error occurs, no further `tasks` will be performed, and the results object
|
||||
* will only contain partial results. Invoked with (err, results).
|
||||
* @returns {Promise} a promise, if a callback is not passed
|
||||
* @example
|
||||
*
|
||||
* //Using Callbacks
|
||||
* async.auto({
|
||||
* get_data: function(callback) {
|
||||
* // async code to get some data
|
||||
* callback(null, 'data', 'converted to array');
|
||||
* },
|
||||
* make_folder: function(callback) {
|
||||
* // async code to create a directory to store a file in
|
||||
* // this is run at the same time as getting the data
|
||||
* callback(null, 'folder');
|
||||
* },
|
||||
* write_file: ['get_data', 'make_folder', function(results, callback) {
|
||||
* // once there is some data and the directory exists,
|
||||
* // write the data to a file in the directory
|
||||
* callback(null, 'filename');
|
||||
* }],
|
||||
* email_link: ['write_file', function(results, callback) {
|
||||
* // once the file is written let's email a link to it...
|
||||
* callback(null, {'file':results.write_file, 'email':'user@example.com'});
|
||||
* }]
|
||||
* }, function(err, results) {
|
||||
* if (err) {
|
||||
* console.log('err = ', err);
|
||||
* }
|
||||
* console.log('results = ', results);
|
||||
* // results = {
|
||||
* // get_data: ['data', 'converted to array']
|
||||
* // make_folder; 'folder',
|
||||
* // write_file: 'filename'
|
||||
* // email_link: { file: 'filename', email: 'user@example.com' }
|
||||
* // }
|
||||
* });
|
||||
*
|
||||
* //Using Promises
|
||||
* async.auto({
|
||||
* get_data: function(callback) {
|
||||
* console.log('in get_data');
|
||||
* // async code to get some data
|
||||
* callback(null, 'data', 'converted to array');
|
||||
* },
|
||||
* make_folder: function(callback) {
|
||||
* console.log('in make_folder');
|
||||
* // async code to create a directory to store a file in
|
||||
* // this is run at the same time as getting the data
|
||||
* callback(null, 'folder');
|
||||
* },
|
||||
* write_file: ['get_data', 'make_folder', function(results, callback) {
|
||||
* // once there is some data and the directory exists,
|
||||
* // write the data to a file in the directory
|
||||
* callback(null, 'filename');
|
||||
* }],
|
||||
* email_link: ['write_file', function(results, callback) {
|
||||
* // once the file is written let's email a link to it...
|
||||
* callback(null, {'file':results.write_file, 'email':'user@example.com'});
|
||||
* }]
|
||||
* }).then(results => {
|
||||
* console.log('results = ', results);
|
||||
* // results = {
|
||||
* // get_data: ['data', 'converted to array']
|
||||
* // make_folder; 'folder',
|
||||
* // write_file: 'filename'
|
||||
* // email_link: { file: 'filename', email: 'user@example.com' }
|
||||
* // }
|
||||
* }).catch(err => {
|
||||
* console.log('err = ', err);
|
||||
* });
|
||||
*
|
||||
* //Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let results = await async.auto({
|
||||
* get_data: function(callback) {
|
||||
* // async code to get some data
|
||||
* callback(null, 'data', 'converted to array');
|
||||
* },
|
||||
* make_folder: function(callback) {
|
||||
* // async code to create a directory to store a file in
|
||||
* // this is run at the same time as getting the data
|
||||
* callback(null, 'folder');
|
||||
* },
|
||||
* write_file: ['get_data', 'make_folder', function(results, callback) {
|
||||
* // once there is some data and the directory exists,
|
||||
* // write the data to a file in the directory
|
||||
* callback(null, 'filename');
|
||||
* }],
|
||||
* email_link: ['write_file', function(results, callback) {
|
||||
* // once the file is written let's email a link to it...
|
||||
* callback(null, {'file':results.write_file, 'email':'user@example.com'});
|
||||
* }]
|
||||
* });
|
||||
* console.log('results = ', results);
|
||||
* // results = {
|
||||
* // get_data: ['data', 'converted to array']
|
||||
* // make_folder; 'folder',
|
||||
* // write_file: 'filename'
|
||||
* // email_link: { file: 'filename', email: 'user@example.com' }
|
||||
* // }
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function auto(tasks, concurrency, callback) {
|
||||
if (typeof concurrency !== 'number') {
|
||||
// concurrency is optional, shift the args.
|
||||
callback = concurrency;
|
||||
concurrency = null;
|
||||
}
|
||||
callback = (0, _once2.default)(callback || (0, _promiseCallback.promiseCallback)());
|
||||
var numTasks = Object.keys(tasks).length;
|
||||
if (!numTasks) {
|
||||
return callback(null);
|
||||
}
|
||||
if (!concurrency) {
|
||||
concurrency = numTasks;
|
||||
}
|
||||
|
||||
var results = {};
|
||||
var runningTasks = 0;
|
||||
var canceled = false;
|
||||
var hasError = false;
|
||||
|
||||
var listeners = Object.create(null);
|
||||
|
||||
var readyTasks = [];
|
||||
|
||||
// for cycle detection:
|
||||
var readyToCheck = []; // tasks that have been identified as reachable
|
||||
// without the possibility of returning to an ancestor task
|
||||
var uncheckedDependencies = {};
|
||||
|
||||
Object.keys(tasks).forEach(key => {
|
||||
var task = tasks[key];
|
||||
if (!Array.isArray(task)) {
|
||||
// no dependencies
|
||||
enqueueTask(key, [task]);
|
||||
readyToCheck.push(key);
|
||||
return;
|
||||
}
|
||||
|
||||
var dependencies = task.slice(0, task.length - 1);
|
||||
var remainingDependencies = dependencies.length;
|
||||
if (remainingDependencies === 0) {
|
||||
enqueueTask(key, task);
|
||||
readyToCheck.push(key);
|
||||
return;
|
||||
}
|
||||
uncheckedDependencies[key] = remainingDependencies;
|
||||
|
||||
dependencies.forEach(dependencyName => {
|
||||
if (!tasks[dependencyName]) {
|
||||
throw new Error('async.auto task `' + key + '` has a non-existent dependency `' + dependencyName + '` in ' + dependencies.join(', '));
|
||||
}
|
||||
addListener(dependencyName, () => {
|
||||
remainingDependencies--;
|
||||
if (remainingDependencies === 0) {
|
||||
enqueueTask(key, task);
|
||||
}
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
checkForDeadlocks();
|
||||
processQueue();
|
||||
|
||||
function enqueueTask(key, task) {
|
||||
readyTasks.push(() => runTask(key, task));
|
||||
}
|
||||
|
||||
function processQueue() {
|
||||
if (canceled) return;
|
||||
if (readyTasks.length === 0 && runningTasks === 0) {
|
||||
return callback(null, results);
|
||||
}
|
||||
while (readyTasks.length && runningTasks < concurrency) {
|
||||
var run = readyTasks.shift();
|
||||
run();
|
||||
}
|
||||
}
|
||||
|
||||
function addListener(taskName, fn) {
|
||||
var taskListeners = listeners[taskName];
|
||||
if (!taskListeners) {
|
||||
taskListeners = listeners[taskName] = [];
|
||||
}
|
||||
|
||||
taskListeners.push(fn);
|
||||
}
|
||||
|
||||
function taskComplete(taskName) {
|
||||
var taskListeners = listeners[taskName] || [];
|
||||
taskListeners.forEach(fn => fn());
|
||||
processQueue();
|
||||
}
|
||||
|
||||
function runTask(key, task) {
|
||||
if (hasError) return;
|
||||
|
||||
var taskCallback = (0, _onlyOnce2.default)((err, ...result) => {
|
||||
runningTasks--;
|
||||
if (err === false) {
|
||||
canceled = true;
|
||||
return;
|
||||
}
|
||||
if (result.length < 2) {
|
||||
[result] = result;
|
||||
}
|
||||
if (err) {
|
||||
var safeResults = {};
|
||||
Object.keys(results).forEach(rkey => {
|
||||
safeResults[rkey] = results[rkey];
|
||||
});
|
||||
safeResults[key] = result;
|
||||
hasError = true;
|
||||
listeners = Object.create(null);
|
||||
if (canceled) return;
|
||||
callback(err, safeResults);
|
||||
} else {
|
||||
results[key] = result;
|
||||
taskComplete(key);
|
||||
}
|
||||
});
|
||||
|
||||
runningTasks++;
|
||||
var taskFn = (0, _wrapAsync2.default)(task[task.length - 1]);
|
||||
if (task.length > 1) {
|
||||
taskFn(results, taskCallback);
|
||||
} else {
|
||||
taskFn(taskCallback);
|
||||
}
|
||||
}
|
||||
|
||||
function checkForDeadlocks() {
|
||||
// Kahn's algorithm
|
||||
// https://en.wikipedia.org/wiki/Topological_sorting#Kahn.27s_algorithm
|
||||
// http://connalle.blogspot.com/2013/10/topological-sortingkahn-algorithm.html
|
||||
var currentTask;
|
||||
var counter = 0;
|
||||
while (readyToCheck.length) {
|
||||
currentTask = readyToCheck.pop();
|
||||
counter++;
|
||||
getDependents(currentTask).forEach(dependent => {
|
||||
if (--uncheckedDependencies[dependent] === 0) {
|
||||
readyToCheck.push(dependent);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
if (counter !== numTasks) {
|
||||
throw new Error('async.auto cannot execute tasks due to a recursive dependency');
|
||||
}
|
||||
}
|
||||
|
||||
function getDependents(taskName) {
|
||||
var result = [];
|
||||
Object.keys(tasks).forEach(key => {
|
||||
const task = tasks[key];
|
||||
if (Array.isArray(task) && task.indexOf(taskName) >= 0) {
|
||||
result.push(key);
|
||||
}
|
||||
});
|
||||
return result;
|
||||
}
|
||||
|
||||
return callback[_promiseCallback.PROMISE_SYMBOL];
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,182 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = autoInject;
|
||||
|
||||
var _auto = require('./auto.js');
|
||||
|
||||
var _auto2 = _interopRequireDefault(_auto);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
var FN_ARGS = /^(?:async\s+)?(?:function)?\s*\w*\s*\(\s*([^)]+)\s*\)(?:\s*{)/;
|
||||
var ARROW_FN_ARGS = /^(?:async\s+)?\(?\s*([^)=]+)\s*\)?(?:\s*=>)/;
|
||||
var FN_ARG_SPLIT = /,/;
|
||||
var FN_ARG = /(=.+)?(\s*)$/;
|
||||
|
||||
function stripComments(string) {
|
||||
let stripped = '';
|
||||
let index = 0;
|
||||
let endBlockComment = string.indexOf('*/');
|
||||
while (index < string.length) {
|
||||
if (string[index] === '/' && string[index + 1] === '/') {
|
||||
// inline comment
|
||||
let endIndex = string.indexOf('\n', index);
|
||||
index = endIndex === -1 ? string.length : endIndex;
|
||||
} else if (endBlockComment !== -1 && string[index] === '/' && string[index + 1] === '*') {
|
||||
// block comment
|
||||
let endIndex = string.indexOf('*/', index);
|
||||
if (endIndex !== -1) {
|
||||
index = endIndex + 2;
|
||||
endBlockComment = string.indexOf('*/', index);
|
||||
} else {
|
||||
stripped += string[index];
|
||||
index++;
|
||||
}
|
||||
} else {
|
||||
stripped += string[index];
|
||||
index++;
|
||||
}
|
||||
}
|
||||
return stripped;
|
||||
}
|
||||
|
||||
function parseParams(func) {
|
||||
const src = stripComments(func.toString());
|
||||
let match = src.match(FN_ARGS);
|
||||
if (!match) {
|
||||
match = src.match(ARROW_FN_ARGS);
|
||||
}
|
||||
if (!match) throw new Error('could not parse args in autoInject\nSource:\n' + src);
|
||||
let [, args] = match;
|
||||
return args.replace(/\s/g, '').split(FN_ARG_SPLIT).map(arg => arg.replace(FN_ARG, '').trim());
|
||||
}
|
||||
|
||||
/**
|
||||
* A dependency-injected version of the [async.auto]{@link module:ControlFlow.auto} function. Dependent
|
||||
* tasks are specified as parameters to the function, after the usual callback
|
||||
* parameter, with the parameter names matching the names of the tasks it
|
||||
* depends on. This can provide even more readable task graphs which can be
|
||||
* easier to maintain.
|
||||
*
|
||||
* If a final callback is specified, the task results are similarly injected,
|
||||
* specified as named parameters after the initial error parameter.
|
||||
*
|
||||
* The autoInject function is purely syntactic sugar and its semantics are
|
||||
* otherwise equivalent to [async.auto]{@link module:ControlFlow.auto}.
|
||||
*
|
||||
* @name autoInject
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @see [async.auto]{@link module:ControlFlow.auto}
|
||||
* @category Control Flow
|
||||
* @param {Object} tasks - An object, each of whose properties is an {@link AsyncFunction} of
|
||||
* the form 'func([dependencies...], callback). The object's key of a property
|
||||
* serves as the name of the task defined by that property, i.e. can be used
|
||||
* when specifying requirements for other tasks.
|
||||
* * The `callback` parameter is a `callback(err, result)` which must be called
|
||||
* when finished, passing an `error` (which can be `null`) and the result of
|
||||
* the function's execution. The remaining parameters name other tasks on
|
||||
* which the task is dependent, and the results from those tasks are the
|
||||
* arguments of those parameters.
|
||||
* @param {Function} [callback] - An optional callback which is called when all
|
||||
* the tasks have been completed. It receives the `err` argument if any `tasks`
|
||||
* pass an error to their callback, and a `results` object with any completed
|
||||
* task results, similar to `auto`.
|
||||
* @returns {Promise} a promise, if no callback is passed
|
||||
* @example
|
||||
*
|
||||
* // The example from `auto` can be rewritten as follows:
|
||||
* async.autoInject({
|
||||
* get_data: function(callback) {
|
||||
* // async code to get some data
|
||||
* callback(null, 'data', 'converted to array');
|
||||
* },
|
||||
* make_folder: function(callback) {
|
||||
* // async code to create a directory to store a file in
|
||||
* // this is run at the same time as getting the data
|
||||
* callback(null, 'folder');
|
||||
* },
|
||||
* write_file: function(get_data, make_folder, callback) {
|
||||
* // once there is some data and the directory exists,
|
||||
* // write the data to a file in the directory
|
||||
* callback(null, 'filename');
|
||||
* },
|
||||
* email_link: function(write_file, callback) {
|
||||
* // once the file is written let's email a link to it...
|
||||
* // write_file contains the filename returned by write_file.
|
||||
* callback(null, {'file':write_file, 'email':'user@example.com'});
|
||||
* }
|
||||
* }, function(err, results) {
|
||||
* console.log('err = ', err);
|
||||
* console.log('email_link = ', results.email_link);
|
||||
* });
|
||||
*
|
||||
* // If you are using a JS minifier that mangles parameter names, `autoInject`
|
||||
* // will not work with plain functions, since the parameter names will be
|
||||
* // collapsed to a single letter identifier. To work around this, you can
|
||||
* // explicitly specify the names of the parameters your task function needs
|
||||
* // in an array, similar to Angular.js dependency injection.
|
||||
*
|
||||
* // This still has an advantage over plain `auto`, since the results a task
|
||||
* // depends on are still spread into arguments.
|
||||
* async.autoInject({
|
||||
* //...
|
||||
* write_file: ['get_data', 'make_folder', function(get_data, make_folder, callback) {
|
||||
* callback(null, 'filename');
|
||||
* }],
|
||||
* email_link: ['write_file', function(write_file, callback) {
|
||||
* callback(null, {'file':write_file, 'email':'user@example.com'});
|
||||
* }]
|
||||
* //...
|
||||
* }, function(err, results) {
|
||||
* console.log('err = ', err);
|
||||
* console.log('email_link = ', results.email_link);
|
||||
* });
|
||||
*/
|
||||
function autoInject(tasks, callback) {
|
||||
var newTasks = {};
|
||||
|
||||
Object.keys(tasks).forEach(key => {
|
||||
var taskFn = tasks[key];
|
||||
var params;
|
||||
var fnIsAsync = (0, _wrapAsync.isAsync)(taskFn);
|
||||
var hasNoDeps = !fnIsAsync && taskFn.length === 1 || fnIsAsync && taskFn.length === 0;
|
||||
|
||||
if (Array.isArray(taskFn)) {
|
||||
params = [...taskFn];
|
||||
taskFn = params.pop();
|
||||
|
||||
newTasks[key] = params.concat(params.length > 0 ? newTask : taskFn);
|
||||
} else if (hasNoDeps) {
|
||||
// no dependencies, use the function as-is
|
||||
newTasks[key] = taskFn;
|
||||
} else {
|
||||
params = parseParams(taskFn);
|
||||
if (taskFn.length === 0 && !fnIsAsync && params.length === 0) {
|
||||
throw new Error("autoInject task functions require explicit parameters.");
|
||||
}
|
||||
|
||||
// remove callback param
|
||||
if (!fnIsAsync) params.pop();
|
||||
|
||||
newTasks[key] = params.concat(newTask);
|
||||
}
|
||||
|
||||
function newTask(results, taskCb) {
|
||||
var newArgs = params.map(name => results[name]);
|
||||
newArgs.push(taskCb);
|
||||
(0, _wrapAsync2.default)(taskFn)(...newArgs);
|
||||
}
|
||||
});
|
||||
|
||||
return (0, _auto2.default)(newTasks, callback);
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,17 +0,0 @@
|
|||
{
|
||||
"name": "async",
|
||||
"main": "dist/async.js",
|
||||
"ignore": [
|
||||
"bower_components",
|
||||
"lib",
|
||||
"test",
|
||||
"node_modules",
|
||||
"perf",
|
||||
"support",
|
||||
"**/.*",
|
||||
"*.config.js",
|
||||
"*.json",
|
||||
"index.js",
|
||||
"Makefile"
|
||||
]
|
||||
}
|
||||
|
|
@ -1,63 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = cargo;
|
||||
|
||||
var _queue = require('./internal/queue.js');
|
||||
|
||||
var _queue2 = _interopRequireDefault(_queue);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Creates a `cargo` object with the specified payload. Tasks added to the
|
||||
* cargo will be processed altogether (up to the `payload` limit). If the
|
||||
* `worker` is in progress, the task is queued until it becomes available. Once
|
||||
* the `worker` has completed some tasks, each callback of those tasks is
|
||||
* called. Check out [these](https://camo.githubusercontent.com/6bbd36f4cf5b35a0f11a96dcd2e97711ffc2fb37/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f313637363837312f36383130382f62626330636662302d356632392d313165322d393734662d3333393763363464633835382e676966) [animations](https://camo.githubusercontent.com/f4810e00e1c5f5f8addbe3e9f49064fd5d102699/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f313637363837312f36383130312f38346339323036362d356632392d313165322d383134662d3964336430323431336266642e676966)
|
||||
* for how `cargo` and `queue` work.
|
||||
*
|
||||
* While [`queue`]{@link module:ControlFlow.queue} passes only one task to one of a group of workers
|
||||
* at a time, cargo passes an array of tasks to a single worker, repeating
|
||||
* when the worker is finished.
|
||||
*
|
||||
* @name cargo
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @see [async.queue]{@link module:ControlFlow.queue}
|
||||
* @category Control Flow
|
||||
* @param {AsyncFunction} worker - An asynchronous function for processing an array
|
||||
* of queued tasks. Invoked with `(tasks, callback)`.
|
||||
* @param {number} [payload=Infinity] - An optional `integer` for determining
|
||||
* how many tasks should be processed per round; if omitted, the default is
|
||||
* unlimited.
|
||||
* @returns {module:ControlFlow.QueueObject} A cargo object to manage the tasks. Callbacks can
|
||||
* attached as certain properties to listen for specific events during the
|
||||
* lifecycle of the cargo and inner queue.
|
||||
* @example
|
||||
*
|
||||
* // create a cargo object with payload 2
|
||||
* var cargo = async.cargo(function(tasks, callback) {
|
||||
* for (var i=0; i<tasks.length; i++) {
|
||||
* console.log('hello ' + tasks[i].name);
|
||||
* }
|
||||
* callback();
|
||||
* }, 2);
|
||||
*
|
||||
* // add some items
|
||||
* cargo.push({name: 'foo'}, function(err) {
|
||||
* console.log('finished processing foo');
|
||||
* });
|
||||
* cargo.push({name: 'bar'}, function(err) {
|
||||
* console.log('finished processing bar');
|
||||
* });
|
||||
* await cargo.push({name: 'baz'});
|
||||
* console.log('finished processing baz');
|
||||
*/
|
||||
function cargo(worker, payload) {
|
||||
return (0, _queue2.default)(worker, 1, payload);
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,71 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = cargo;
|
||||
|
||||
var _queue = require('./internal/queue.js');
|
||||
|
||||
var _queue2 = _interopRequireDefault(_queue);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Creates a `cargoQueue` object with the specified payload. Tasks added to the
|
||||
* cargoQueue will be processed together (up to the `payload` limit) in `concurrency` parallel workers.
|
||||
* If the all `workers` are in progress, the task is queued until one becomes available. Once
|
||||
* a `worker` has completed some tasks, each callback of those tasks is
|
||||
* called. Check out [these](https://camo.githubusercontent.com/6bbd36f4cf5b35a0f11a96dcd2e97711ffc2fb37/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f313637363837312f36383130382f62626330636662302d356632392d313165322d393734662d3333393763363464633835382e676966) [animations](https://camo.githubusercontent.com/f4810e00e1c5f5f8addbe3e9f49064fd5d102699/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f313637363837312f36383130312f38346339323036362d356632392d313165322d383134662d3964336430323431336266642e676966)
|
||||
* for how `cargo` and `queue` work.
|
||||
*
|
||||
* While [`queue`]{@link module:ControlFlow.queue} passes only one task to one of a group of workers
|
||||
* at a time, and [`cargo`]{@link module:ControlFlow.cargo} passes an array of tasks to a single worker,
|
||||
* the cargoQueue passes an array of tasks to multiple parallel workers.
|
||||
*
|
||||
* @name cargoQueue
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @see [async.queue]{@link module:ControlFlow.queue}
|
||||
* @see [async.cargo]{@link module:ControlFLow.cargo}
|
||||
* @category Control Flow
|
||||
* @param {AsyncFunction} worker - An asynchronous function for processing an array
|
||||
* of queued tasks. Invoked with `(tasks, callback)`.
|
||||
* @param {number} [concurrency=1] - An `integer` for determining how many
|
||||
* `worker` functions should be run in parallel. If omitted, the concurrency
|
||||
* defaults to `1`. If the concurrency is `0`, an error is thrown.
|
||||
* @param {number} [payload=Infinity] - An optional `integer` for determining
|
||||
* how many tasks should be processed per round; if omitted, the default is
|
||||
* unlimited.
|
||||
* @returns {module:ControlFlow.QueueObject} A cargoQueue object to manage the tasks. Callbacks can
|
||||
* attached as certain properties to listen for specific events during the
|
||||
* lifecycle of the cargoQueue and inner queue.
|
||||
* @example
|
||||
*
|
||||
* // create a cargoQueue object with payload 2 and concurrency 2
|
||||
* var cargoQueue = async.cargoQueue(function(tasks, callback) {
|
||||
* for (var i=0; i<tasks.length; i++) {
|
||||
* console.log('hello ' + tasks[i].name);
|
||||
* }
|
||||
* callback();
|
||||
* }, 2, 2);
|
||||
*
|
||||
* // add some items
|
||||
* cargoQueue.push({name: 'foo'}, function(err) {
|
||||
* console.log('finished processing foo');
|
||||
* });
|
||||
* cargoQueue.push({name: 'bar'}, function(err) {
|
||||
* console.log('finished processing bar');
|
||||
* });
|
||||
* cargoQueue.push({name: 'baz'}, function(err) {
|
||||
* console.log('finished processing baz');
|
||||
* });
|
||||
* cargoQueue.push({name: 'boo'}, function(err) {
|
||||
* console.log('finished processing boo');
|
||||
* });
|
||||
*/
|
||||
function cargo(worker, concurrency, payload) {
|
||||
return (0, _queue2.default)(worker, concurrency, payload);
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,55 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = compose;
|
||||
|
||||
var _seq = require('./seq.js');
|
||||
|
||||
var _seq2 = _interopRequireDefault(_seq);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Creates a function which is a composition of the passed asynchronous
|
||||
* functions. Each function consumes the return value of the function that
|
||||
* follows. Composing functions `f()`, `g()`, and `h()` would produce the result
|
||||
* of `f(g(h()))`, only this version uses callbacks to obtain the return values.
|
||||
*
|
||||
* If the last argument to the composed function is not a function, a promise
|
||||
* is returned when you call it.
|
||||
*
|
||||
* Each function is executed with the `this` binding of the composed function.
|
||||
*
|
||||
* @name compose
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @category Control Flow
|
||||
* @param {...AsyncFunction} functions - the asynchronous functions to compose
|
||||
* @returns {Function} an asynchronous function that is the composed
|
||||
* asynchronous `functions`
|
||||
* @example
|
||||
*
|
||||
* function add1(n, callback) {
|
||||
* setTimeout(function () {
|
||||
* callback(null, n + 1);
|
||||
* }, 10);
|
||||
* }
|
||||
*
|
||||
* function mul3(n, callback) {
|
||||
* setTimeout(function () {
|
||||
* callback(null, n * 3);
|
||||
* }, 10);
|
||||
* }
|
||||
*
|
||||
* var add1mul3 = async.compose(mul3, add1);
|
||||
* add1mul3(4, function (err, result) {
|
||||
* // result now equals 15
|
||||
* });
|
||||
*/
|
||||
function compose(...args) {
|
||||
return (0, _seq2.default)(...args.reverse());
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,115 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _concatLimit = require('./concatLimit.js');
|
||||
|
||||
var _concatLimit2 = _interopRequireDefault(_concatLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Applies `iteratee` to each item in `coll`, concatenating the results. Returns
|
||||
* the concatenated list. The `iteratee`s are called in parallel, and the
|
||||
* results are concatenated as they return. The results array will be returned in
|
||||
* the original order of `coll` passed to the `iteratee` function.
|
||||
*
|
||||
* @name concat
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @category Collection
|
||||
* @alias flatMap
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - A function to apply to each item in `coll`,
|
||||
* which should use an array as its result. Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished, or an error occurs. Results is an array
|
||||
* containing the concatenated results of the `iteratee` function. Invoked with
|
||||
* (err, results).
|
||||
* @returns A Promise, if no callback is passed
|
||||
* @example
|
||||
*
|
||||
* // dir1 is a directory that contains file1.txt, file2.txt
|
||||
* // dir2 is a directory that contains file3.txt, file4.txt
|
||||
* // dir3 is a directory that contains file5.txt
|
||||
* // dir4 does not exist
|
||||
*
|
||||
* let directoryList = ['dir1','dir2','dir3'];
|
||||
* let withMissingDirectoryList = ['dir1','dir2','dir3', 'dir4'];
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.concat(directoryList, fs.readdir, function(err, results) {
|
||||
* if (err) {
|
||||
* console.log(err);
|
||||
* } else {
|
||||
* console.log(results);
|
||||
* // [ 'file1.txt', 'file2.txt', 'file3.txt', 'file4.txt', file5.txt ]
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.concat(withMissingDirectoryList, fs.readdir, function(err, results) {
|
||||
* if (err) {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4 does not exist
|
||||
* } else {
|
||||
* console.log(results);
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.concat(directoryList, fs.readdir)
|
||||
* .then(results => {
|
||||
* console.log(results);
|
||||
* // [ 'file1.txt', 'file2.txt', 'file3.txt', 'file4.txt', file5.txt ]
|
||||
* }).catch(err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.concat(withMissingDirectoryList, fs.readdir)
|
||||
* .then(results => {
|
||||
* console.log(results);
|
||||
* }).catch(err => {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4 does not exist
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let results = await async.concat(directoryList, fs.readdir);
|
||||
* console.log(results);
|
||||
* // [ 'file1.txt', 'file2.txt', 'file3.txt', 'file4.txt', file5.txt ]
|
||||
* } catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* // Error Handling
|
||||
* async () => {
|
||||
* try {
|
||||
* let results = await async.concat(withMissingDirectoryList, fs.readdir);
|
||||
* console.log(results);
|
||||
* } catch (err) {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4 does not exist
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function concat(coll, iteratee, callback) {
|
||||
return (0, _concatLimit2.default)(coll, Infinity, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(concat, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,60 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _mapLimit = require('./mapLimit.js');
|
||||
|
||||
var _mapLimit2 = _interopRequireDefault(_mapLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`concat`]{@link module:Collections.concat} but runs a maximum of `limit` async operations at a time.
|
||||
*
|
||||
* @name concatLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.concat]{@link module:Collections.concat}
|
||||
* @category Collection
|
||||
* @alias flatMapLimit
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - A function to apply to each item in `coll`,
|
||||
* which should use an array as its result. Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished, or an error occurs. Results is an array
|
||||
* containing the concatenated results of the `iteratee` function. Invoked with
|
||||
* (err, results).
|
||||
* @returns A Promise, if no callback is passed
|
||||
*/
|
||||
function concatLimit(coll, limit, iteratee, callback) {
|
||||
var _iteratee = (0, _wrapAsync2.default)(iteratee);
|
||||
return (0, _mapLimit2.default)(coll, limit, (val, iterCb) => {
|
||||
_iteratee(val, (err, ...args) => {
|
||||
if (err) return iterCb(err);
|
||||
return iterCb(err, args);
|
||||
});
|
||||
}, (err, mapResults) => {
|
||||
var result = [];
|
||||
for (var i = 0; i < mapResults.length; i++) {
|
||||
if (mapResults[i]) {
|
||||
result = result.concat(...mapResults[i]);
|
||||
}
|
||||
}
|
||||
|
||||
return callback(err, result);
|
||||
});
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(concatLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,41 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _concatLimit = require('./concatLimit.js');
|
||||
|
||||
var _concatLimit2 = _interopRequireDefault(_concatLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`concat`]{@link module:Collections.concat} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name concatSeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.concat]{@link module:Collections.concat}
|
||||
* @category Collection
|
||||
* @alias flatMapSeries
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - A function to apply to each item in `coll`.
|
||||
* The iteratee should complete with an array an array of results.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished, or an error occurs. Results is an array
|
||||
* containing the concatenated results of the `iteratee` function. Invoked with
|
||||
* (err, results).
|
||||
* @returns A Promise, if no callback is passed
|
||||
*/
|
||||
function concatSeries(coll, iteratee, callback) {
|
||||
return (0, _concatLimit2.default)(coll, 1, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(concatSeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,55 +0,0 @@
|
|||
"use strict";
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
exports.default = function (...args) {
|
||||
return function (...ignoredArgs /*, callback*/) {
|
||||
var callback = ignoredArgs.pop();
|
||||
return callback(null, ...args);
|
||||
};
|
||||
};
|
||||
|
||||
module.exports = exports["default"]; /**
|
||||
* Returns a function that when called, calls-back with the values provided.
|
||||
* Useful as the first function in a [`waterfall`]{@link module:ControlFlow.waterfall}, or for plugging values in to
|
||||
* [`auto`]{@link module:ControlFlow.auto}.
|
||||
*
|
||||
* @name constant
|
||||
* @static
|
||||
* @memberOf module:Utils
|
||||
* @method
|
||||
* @category Util
|
||||
* @param {...*} arguments... - Any number of arguments to automatically invoke
|
||||
* callback with.
|
||||
* @returns {AsyncFunction} Returns a function that when invoked, automatically
|
||||
* invokes the callback with the previous given arguments.
|
||||
* @example
|
||||
*
|
||||
* async.waterfall([
|
||||
* async.constant(42),
|
||||
* function (value, next) {
|
||||
* // value === 42
|
||||
* },
|
||||
* //...
|
||||
* ], callback);
|
||||
*
|
||||
* async.waterfall([
|
||||
* async.constant(filename, "utf8"),
|
||||
* fs.readFile,
|
||||
* function (fileData, next) {
|
||||
* //...
|
||||
* }
|
||||
* //...
|
||||
* ], callback);
|
||||
*
|
||||
* async.auto({
|
||||
* hostname: async.constant("https://server.net/"),
|
||||
* port: findFreePort,
|
||||
* launchServer: ["hostname", "port", function (options, cb) {
|
||||
* startServer(options, cb);
|
||||
* }],
|
||||
* //...
|
||||
* }, callback);
|
||||
*/
|
||||
|
|
@ -1,96 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOf = require('./eachOf.js');
|
||||
|
||||
var _eachOf2 = _interopRequireDefault(_eachOf);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Returns the first value in `coll` that passes an async truth test. The
|
||||
* `iteratee` is applied in parallel, meaning the first iteratee to return
|
||||
* `true` will fire the detect `callback` with that result. That means the
|
||||
* result might not be the first item in the original `coll` (in terms of order)
|
||||
* that passes the test.
|
||||
|
||||
* If order within the original `coll` is important, then look at
|
||||
* [`detectSeries`]{@link module:Collections.detectSeries}.
|
||||
*
|
||||
* @name detect
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias find
|
||||
* @category Collections
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - A truth test to apply to each item in `coll`.
|
||||
* The iteratee must complete with a boolean value as its result.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called as soon as any
|
||||
* iteratee returns `true`, or after all the `iteratee` functions have finished.
|
||||
* Result will be the first item in the array that passes the truth test
|
||||
* (iteratee) or the value `undefined` if none passed. Invoked with
|
||||
* (err, result).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
* @example
|
||||
*
|
||||
* // dir1 is a directory that contains file1.txt, file2.txt
|
||||
* // dir2 is a directory that contains file3.txt, file4.txt
|
||||
* // dir3 is a directory that contains file5.txt
|
||||
*
|
||||
* // asynchronous function that checks if a file exists
|
||||
* function fileExists(file, callback) {
|
||||
* fs.access(file, fs.constants.F_OK, (err) => {
|
||||
* callback(null, !err);
|
||||
* });
|
||||
* }
|
||||
*
|
||||
* async.detect(['file3.txt','file2.txt','dir1/file1.txt'], fileExists,
|
||||
* function(err, result) {
|
||||
* console.log(result);
|
||||
* // dir1/file1.txt
|
||||
* // result now equals the first file in the list that exists
|
||||
* }
|
||||
*);
|
||||
*
|
||||
* // Using Promises
|
||||
* async.detect(['file3.txt','file2.txt','dir1/file1.txt'], fileExists)
|
||||
* .then(result => {
|
||||
* console.log(result);
|
||||
* // dir1/file1.txt
|
||||
* // result now equals the first file in the list that exists
|
||||
* }).catch(err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.detect(['file3.txt','file2.txt','dir1/file1.txt'], fileExists);
|
||||
* console.log(result);
|
||||
* // dir1/file1.txt
|
||||
* // result now equals the file in the list that exists
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function detect(coll, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => bool, (res, item) => item)(_eachOf2.default, coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(detect, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,48 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOfLimit = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`detect`]{@link module:Collections.detect} but runs a maximum of `limit` async operations at a
|
||||
* time.
|
||||
*
|
||||
* @name detectLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.detect]{@link module:Collections.detect}
|
||||
* @alias findLimit
|
||||
* @category Collections
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - A truth test to apply to each item in `coll`.
|
||||
* The iteratee must complete with a boolean value as its result.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called as soon as any
|
||||
* iteratee returns `true`, or after all the `iteratee` functions have finished.
|
||||
* Result will be the first item in the array that passes the truth test
|
||||
* (iteratee) or the value `undefined` if none passed. Invoked with
|
||||
* (err, result).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function detectLimit(coll, limit, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => bool, (res, item) => item)((0, _eachOfLimit2.default)(limit), coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(detectLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,47 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOfLimit = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`detect`]{@link module:Collections.detect} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name detectSeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.detect]{@link module:Collections.detect}
|
||||
* @alias findSeries
|
||||
* @category Collections
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - A truth test to apply to each item in `coll`.
|
||||
* The iteratee must complete with a boolean value as its result.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called as soon as any
|
||||
* iteratee returns `true`, or after all the `iteratee` functions have finished.
|
||||
* Result will be the first item in the array that passes the truth test
|
||||
* (iteratee) or the value `undefined` if none passed. Invoked with
|
||||
* (err, result).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function detectSeries(coll, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => bool, (res, item) => item)((0, _eachOfLimit2.default)(1), coll, iteratee, callback);
|
||||
}
|
||||
|
||||
exports.default = (0, _awaitify2.default)(detectSeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,43 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _consoleFunc = require('./internal/consoleFunc.js');
|
||||
|
||||
var _consoleFunc2 = _interopRequireDefault(_consoleFunc);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Logs the result of an [`async` function]{@link AsyncFunction} to the
|
||||
* `console` using `console.dir` to display the properties of the resulting object.
|
||||
* Only works in Node.js or in browsers that support `console.dir` and
|
||||
* `console.error` (such as FF and Chrome).
|
||||
* If multiple arguments are returned from the async function,
|
||||
* `console.dir` is called on each argument in order.
|
||||
*
|
||||
* @name dir
|
||||
* @static
|
||||
* @memberOf module:Utils
|
||||
* @method
|
||||
* @category Util
|
||||
* @param {AsyncFunction} function - The function you want to eventually apply
|
||||
* all arguments to.
|
||||
* @param {...*} arguments... - Any number of arguments to apply to the function.
|
||||
* @example
|
||||
*
|
||||
* // in a module
|
||||
* var hello = function(name, callback) {
|
||||
* setTimeout(function() {
|
||||
* callback(null, {hello: name});
|
||||
* }, 1000);
|
||||
* };
|
||||
*
|
||||
* // in the node repl
|
||||
* node> async.dir(hello, 'world');
|
||||
* {hello: 'world'}
|
||||
*/
|
||||
exports.default = (0, _consoleFunc2.default)('dir');
|
||||
module.exports = exports['default'];
|
||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because one or more lines are too long
File diff suppressed because it is too large
Load Diff
|
|
@ -1,68 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _onlyOnce = require('./internal/onlyOnce.js');
|
||||
|
||||
var _onlyOnce2 = _interopRequireDefault(_onlyOnce);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The post-check version of [`whilst`]{@link module:ControlFlow.whilst}. To reflect the difference in
|
||||
* the order of operations, the arguments `test` and `iteratee` are switched.
|
||||
*
|
||||
* `doWhilst` is to `whilst` as `do while` is to `while` in plain JavaScript.
|
||||
*
|
||||
* @name doWhilst
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @see [async.whilst]{@link module:ControlFlow.whilst}
|
||||
* @category Control Flow
|
||||
* @param {AsyncFunction} iteratee - A function which is called each time `test`
|
||||
* passes. Invoked with (callback).
|
||||
* @param {AsyncFunction} test - asynchronous truth test to perform after each
|
||||
* execution of `iteratee`. Invoked with (...args, callback), where `...args` are the
|
||||
* non-error args from the previous callback of `iteratee`.
|
||||
* @param {Function} [callback] - A callback which is called after the test
|
||||
* function has failed and repeated execution of `iteratee` has stopped.
|
||||
* `callback` will be passed an error and any arguments passed to the final
|
||||
* `iteratee`'s callback. Invoked with (err, [results]);
|
||||
* @returns {Promise} a promise, if no callback is passed
|
||||
*/
|
||||
function doWhilst(iteratee, test, callback) {
|
||||
callback = (0, _onlyOnce2.default)(callback);
|
||||
var _fn = (0, _wrapAsync2.default)(iteratee);
|
||||
var _test = (0, _wrapAsync2.default)(test);
|
||||
var results;
|
||||
|
||||
function next(err, ...args) {
|
||||
if (err) return callback(err);
|
||||
if (err === false) return;
|
||||
results = args;
|
||||
_test(...args, check);
|
||||
}
|
||||
|
||||
function check(err, truth) {
|
||||
if (err) return callback(err);
|
||||
if (err === false) return;
|
||||
if (!truth) return callback(null, ...results);
|
||||
_fn(next);
|
||||
}
|
||||
|
||||
return check(null, true);
|
||||
}
|
||||
|
||||
exports.default = (0, _awaitify2.default)(doWhilst, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,46 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = doUntil;
|
||||
|
||||
var _doWhilst = require('./doWhilst.js');
|
||||
|
||||
var _doWhilst2 = _interopRequireDefault(_doWhilst);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Like ['doWhilst']{@link module:ControlFlow.doWhilst}, except the `test` is inverted. Note the
|
||||
* argument ordering differs from `until`.
|
||||
*
|
||||
* @name doUntil
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @see [async.doWhilst]{@link module:ControlFlow.doWhilst}
|
||||
* @category Control Flow
|
||||
* @param {AsyncFunction} iteratee - An async function which is called each time
|
||||
* `test` fails. Invoked with (callback).
|
||||
* @param {AsyncFunction} test - asynchronous truth test to perform after each
|
||||
* execution of `iteratee`. Invoked with (...args, callback), where `...args` are the
|
||||
* non-error args from the previous callback of `iteratee`
|
||||
* @param {Function} [callback] - A callback which is called after the test
|
||||
* function has passed and repeated execution of `iteratee` has stopped. `callback`
|
||||
* will be passed an error and any arguments passed to the final `iteratee`'s
|
||||
* callback. Invoked with (err, [results]);
|
||||
* @returns {Promise} a promise, if no callback is passed
|
||||
*/
|
||||
function doUntil(iteratee, test, callback) {
|
||||
const _test = (0, _wrapAsync2.default)(test);
|
||||
return (0, _doWhilst2.default)(iteratee, (...args) => {
|
||||
const cb = args.pop();
|
||||
_test(...args, (err, truth) => cb(err, !truth));
|
||||
}, callback);
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,68 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _onlyOnce = require('./internal/onlyOnce.js');
|
||||
|
||||
var _onlyOnce2 = _interopRequireDefault(_onlyOnce);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The post-check version of [`whilst`]{@link module:ControlFlow.whilst}. To reflect the difference in
|
||||
* the order of operations, the arguments `test` and `iteratee` are switched.
|
||||
*
|
||||
* `doWhilst` is to `whilst` as `do while` is to `while` in plain JavaScript.
|
||||
*
|
||||
* @name doWhilst
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @see [async.whilst]{@link module:ControlFlow.whilst}
|
||||
* @category Control Flow
|
||||
* @param {AsyncFunction} iteratee - A function which is called each time `test`
|
||||
* passes. Invoked with (callback).
|
||||
* @param {AsyncFunction} test - asynchronous truth test to perform after each
|
||||
* execution of `iteratee`. Invoked with (...args, callback), where `...args` are the
|
||||
* non-error args from the previous callback of `iteratee`.
|
||||
* @param {Function} [callback] - A callback which is called after the test
|
||||
* function has failed and repeated execution of `iteratee` has stopped.
|
||||
* `callback` will be passed an error and any arguments passed to the final
|
||||
* `iteratee`'s callback. Invoked with (err, [results]);
|
||||
* @returns {Promise} a promise, if no callback is passed
|
||||
*/
|
||||
function doWhilst(iteratee, test, callback) {
|
||||
callback = (0, _onlyOnce2.default)(callback);
|
||||
var _fn = (0, _wrapAsync2.default)(iteratee);
|
||||
var _test = (0, _wrapAsync2.default)(test);
|
||||
var results;
|
||||
|
||||
function next(err, ...args) {
|
||||
if (err) return callback(err);
|
||||
if (err === false) return;
|
||||
results = args;
|
||||
_test(...args, check);
|
||||
}
|
||||
|
||||
function check(err, truth) {
|
||||
if (err) return callback(err);
|
||||
if (err === false) return;
|
||||
if (!truth) return callback(null, ...results);
|
||||
_fn(next);
|
||||
}
|
||||
|
||||
return check(null, true);
|
||||
}
|
||||
|
||||
exports.default = (0, _awaitify2.default)(doWhilst, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,78 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _onlyOnce = require('./internal/onlyOnce.js');
|
||||
|
||||
var _onlyOnce2 = _interopRequireDefault(_onlyOnce);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Repeatedly call `iteratee`, while `test` returns `true`. Calls `callback` when
|
||||
* stopped, or an error occurs.
|
||||
*
|
||||
* @name whilst
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @category Control Flow
|
||||
* @param {AsyncFunction} test - asynchronous truth test to perform before each
|
||||
* execution of `iteratee`. Invoked with ().
|
||||
* @param {AsyncFunction} iteratee - An async function which is called each time
|
||||
* `test` passes. Invoked with (callback).
|
||||
* @param {Function} [callback] - A callback which is called after the test
|
||||
* function has failed and repeated execution of `iteratee` has stopped. `callback`
|
||||
* will be passed an error and any arguments passed to the final `iteratee`'s
|
||||
* callback. Invoked with (err, [results]);
|
||||
* @returns {Promise} a promise, if no callback is passed
|
||||
* @example
|
||||
*
|
||||
* var count = 0;
|
||||
* async.whilst(
|
||||
* function test(cb) { cb(null, count < 5); },
|
||||
* function iter(callback) {
|
||||
* count++;
|
||||
* setTimeout(function() {
|
||||
* callback(null, count);
|
||||
* }, 1000);
|
||||
* },
|
||||
* function (err, n) {
|
||||
* // 5 seconds have passed, n = 5
|
||||
* }
|
||||
* );
|
||||
*/
|
||||
function whilst(test, iteratee, callback) {
|
||||
callback = (0, _onlyOnce2.default)(callback);
|
||||
var _fn = (0, _wrapAsync2.default)(iteratee);
|
||||
var _test = (0, _wrapAsync2.default)(test);
|
||||
var results = [];
|
||||
|
||||
function next(err, ...rest) {
|
||||
if (err) return callback(err);
|
||||
results = rest;
|
||||
if (err === false) return;
|
||||
_test(check);
|
||||
}
|
||||
|
||||
function check(err, truth) {
|
||||
if (err) return callback(err);
|
||||
if (err === false) return;
|
||||
if (!truth) return callback(null, ...results);
|
||||
_fn(next);
|
||||
}
|
||||
|
||||
return _test(check);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(whilst, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,129 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachOf = require('./eachOf.js');
|
||||
|
||||
var _eachOf2 = _interopRequireDefault(_eachOf);
|
||||
|
||||
var _withoutIndex = require('./internal/withoutIndex.js');
|
||||
|
||||
var _withoutIndex2 = _interopRequireDefault(_withoutIndex);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Applies the function `iteratee` to each item in `coll`, in parallel.
|
||||
* The `iteratee` is called with an item from the list, and a callback for when
|
||||
* it has finished. If the `iteratee` passes an error to its `callback`, the
|
||||
* main `callback` (for the `each` function) is immediately called with the
|
||||
* error.
|
||||
*
|
||||
* Note, that since this function applies `iteratee` to each item in parallel,
|
||||
* there is no guarantee that the iteratee functions will complete in order.
|
||||
*
|
||||
* @name each
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias forEach
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to
|
||||
* each item in `coll`. Invoked with (item, callback).
|
||||
* The array index is not passed to the iteratee.
|
||||
* If you need the index, use `eachOf`.
|
||||
* @param {Function} [callback] - A callback which is called when all
|
||||
* `iteratee` functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
* @example
|
||||
*
|
||||
* // dir1 is a directory that contains file1.txt, file2.txt
|
||||
* // dir2 is a directory that contains file3.txt, file4.txt
|
||||
* // dir3 is a directory that contains file5.txt
|
||||
* // dir4 does not exist
|
||||
*
|
||||
* const fileList = [ 'dir1/file2.txt', 'dir2/file3.txt', 'dir/file5.txt'];
|
||||
* const withMissingFileList = ['dir1/file1.txt', 'dir4/file2.txt'];
|
||||
*
|
||||
* // asynchronous function that deletes a file
|
||||
* const deleteFile = function(file, callback) {
|
||||
* fs.unlink(file, callback);
|
||||
* };
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.each(fileList, deleteFile, function(err) {
|
||||
* if( err ) {
|
||||
* console.log(err);
|
||||
* } else {
|
||||
* console.log('All files have been deleted successfully');
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.each(withMissingFileList, deleteFile, function(err){
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4/file2.txt does not exist
|
||||
* // dir1/file1.txt could have been deleted
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.each(fileList, deleteFile)
|
||||
* .then( () => {
|
||||
* console.log('All files have been deleted successfully');
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.each(fileList, deleteFile)
|
||||
* .then( () => {
|
||||
* console.log('All files have been deleted successfully');
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4/file2.txt does not exist
|
||||
* // dir1/file1.txt could have been deleted
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* await async.each(files, deleteFile);
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* // Error Handling
|
||||
* async () => {
|
||||
* try {
|
||||
* await async.each(withMissingFileList, deleteFile);
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4/file2.txt does not exist
|
||||
* // dir1/file1.txt could have been deleted
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function eachLimit(coll, iteratee, callback) {
|
||||
return (0, _eachOf2.default)(coll, (0, _withoutIndex2.default)((0, _wrapAsync2.default)(iteratee)), callback);
|
||||
}
|
||||
|
||||
exports.default = (0, _awaitify2.default)(eachLimit, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,50 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachOfLimit = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _withoutIndex = require('./internal/withoutIndex.js');
|
||||
|
||||
var _withoutIndex2 = _interopRequireDefault(_withoutIndex);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`each`]{@link module:Collections.each} but runs a maximum of `limit` async operations at a time.
|
||||
*
|
||||
* @name eachLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.each]{@link module:Collections.each}
|
||||
* @alias forEachLimit
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to each item in
|
||||
* `coll`.
|
||||
* The array index is not passed to the iteratee.
|
||||
* If you need the index, use `eachOfLimit`.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all
|
||||
* `iteratee` functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function eachLimit(coll, limit, iteratee, callback) {
|
||||
return (0, _eachOfLimit2.default)(limit)(coll, (0, _withoutIndex2.default)((0, _wrapAsync2.default)(iteratee)), callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(eachLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,185 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _isArrayLike = require('./internal/isArrayLike.js');
|
||||
|
||||
var _isArrayLike2 = _interopRequireDefault(_isArrayLike);
|
||||
|
||||
var _breakLoop = require('./internal/breakLoop.js');
|
||||
|
||||
var _breakLoop2 = _interopRequireDefault(_breakLoop);
|
||||
|
||||
var _eachOfLimit = require('./eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _once = require('./internal/once.js');
|
||||
|
||||
var _once2 = _interopRequireDefault(_once);
|
||||
|
||||
var _onlyOnce = require('./internal/onlyOnce.js');
|
||||
|
||||
var _onlyOnce2 = _interopRequireDefault(_onlyOnce);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
// eachOf implementation optimized for array-likes
|
||||
function eachOfArrayLike(coll, iteratee, callback) {
|
||||
callback = (0, _once2.default)(callback);
|
||||
var index = 0,
|
||||
completed = 0,
|
||||
{ length } = coll,
|
||||
canceled = false;
|
||||
if (length === 0) {
|
||||
callback(null);
|
||||
}
|
||||
|
||||
function iteratorCallback(err, value) {
|
||||
if (err === false) {
|
||||
canceled = true;
|
||||
}
|
||||
if (canceled === true) return;
|
||||
if (err) {
|
||||
callback(err);
|
||||
} else if (++completed === length || value === _breakLoop2.default) {
|
||||
callback(null);
|
||||
}
|
||||
}
|
||||
|
||||
for (; index < length; index++) {
|
||||
iteratee(coll[index], index, (0, _onlyOnce2.default)(iteratorCallback));
|
||||
}
|
||||
}
|
||||
|
||||
// a generic version of eachOf which can handle array, object, and iterator cases.
|
||||
function eachOfGeneric(coll, iteratee, callback) {
|
||||
return (0, _eachOfLimit2.default)(coll, Infinity, iteratee, callback);
|
||||
}
|
||||
|
||||
/**
|
||||
* Like [`each`]{@link module:Collections.each}, except that it passes the key (or index) as the second argument
|
||||
* to the iteratee.
|
||||
*
|
||||
* @name eachOf
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias forEachOf
|
||||
* @category Collection
|
||||
* @see [async.each]{@link module:Collections.each}
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - A function to apply to each
|
||||
* item in `coll`.
|
||||
* The `key` is the item's key, or index in the case of an array.
|
||||
* Invoked with (item, key, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all
|
||||
* `iteratee` functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
* @example
|
||||
*
|
||||
* // dev.json is a file containing a valid json object config for dev environment
|
||||
* // dev.json is a file containing a valid json object config for test environment
|
||||
* // prod.json is a file containing a valid json object config for prod environment
|
||||
* // invalid.json is a file with a malformed json object
|
||||
*
|
||||
* let configs = {}; //global variable
|
||||
* let validConfigFileMap = {dev: 'dev.json', test: 'test.json', prod: 'prod.json'};
|
||||
* let invalidConfigFileMap = {dev: 'dev.json', test: 'test.json', invalid: 'invalid.json'};
|
||||
*
|
||||
* // asynchronous function that reads a json file and parses the contents as json object
|
||||
* function parseFile(file, key, callback) {
|
||||
* fs.readFile(file, "utf8", function(err, data) {
|
||||
* if (err) return calback(err);
|
||||
* try {
|
||||
* configs[key] = JSON.parse(data);
|
||||
* } catch (e) {
|
||||
* return callback(e);
|
||||
* }
|
||||
* callback();
|
||||
* });
|
||||
* }
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.forEachOf(validConfigFileMap, parseFile, function (err) {
|
||||
* if (err) {
|
||||
* console.error(err);
|
||||
* } else {
|
||||
* console.log(configs);
|
||||
* // configs is now a map of JSON data, e.g.
|
||||
* // { dev: //parsed dev.json, test: //parsed test.json, prod: //parsed prod.json}
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* //Error handing
|
||||
* async.forEachOf(invalidConfigFileMap, parseFile, function (err) {
|
||||
* if (err) {
|
||||
* console.error(err);
|
||||
* // JSON parse error exception
|
||||
* } else {
|
||||
* console.log(configs);
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.forEachOf(validConfigFileMap, parseFile)
|
||||
* .then( () => {
|
||||
* console.log(configs);
|
||||
* // configs is now a map of JSON data, e.g.
|
||||
* // { dev: //parsed dev.json, test: //parsed test.json, prod: //parsed prod.json}
|
||||
* }).catch( err => {
|
||||
* console.error(err);
|
||||
* });
|
||||
*
|
||||
* //Error handing
|
||||
* async.forEachOf(invalidConfigFileMap, parseFile)
|
||||
* .then( () => {
|
||||
* console.log(configs);
|
||||
* }).catch( err => {
|
||||
* console.error(err);
|
||||
* // JSON parse error exception
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.forEachOf(validConfigFileMap, parseFile);
|
||||
* console.log(configs);
|
||||
* // configs is now a map of JSON data, e.g.
|
||||
* // { dev: //parsed dev.json, test: //parsed test.json, prod: //parsed prod.json}
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* //Error handing
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.forEachOf(invalidConfigFileMap, parseFile);
|
||||
* console.log(configs);
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* // JSON parse error exception
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function eachOf(coll, iteratee, callback) {
|
||||
var eachOfImplementation = (0, _isArrayLike2.default)(coll) ? eachOfArrayLike : eachOfGeneric;
|
||||
return eachOfImplementation(coll, (0, _wrapAsync2.default)(iteratee), callback);
|
||||
}
|
||||
|
||||
exports.default = (0, _awaitify2.default)(eachOf, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,47 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachOfLimit2 = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit3 = _interopRequireDefault(_eachOfLimit2);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`eachOf`]{@link module:Collections.eachOf} but runs a maximum of `limit` async operations at a
|
||||
* time.
|
||||
*
|
||||
* @name eachOfLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.eachOf]{@link module:Collections.eachOf}
|
||||
* @alias forEachOfLimit
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to each
|
||||
* item in `coll`. The `key` is the item's key, or index in the case of an
|
||||
* array.
|
||||
* Invoked with (item, key, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all
|
||||
* `iteratee` functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function eachOfLimit(coll, limit, iteratee, callback) {
|
||||
return (0, _eachOfLimit3.default)(limit)(coll, (0, _wrapAsync2.default)(iteratee), callback);
|
||||
}
|
||||
|
||||
exports.default = (0, _awaitify2.default)(eachOfLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,39 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachOfLimit = require('./eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`eachOf`]{@link module:Collections.eachOf} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name eachOfSeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.eachOf]{@link module:Collections.eachOf}
|
||||
* @alias forEachOfSeries
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to each item in
|
||||
* `coll`.
|
||||
* Invoked with (item, key, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all `iteratee`
|
||||
* functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function eachOfSeries(coll, iteratee, callback) {
|
||||
return (0, _eachOfLimit2.default)(coll, 1, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(eachOfSeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,44 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachLimit = require('./eachLimit.js');
|
||||
|
||||
var _eachLimit2 = _interopRequireDefault(_eachLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`each`]{@link module:Collections.each} but runs only a single async operation at a time.
|
||||
*
|
||||
* Note, that unlike [`each`]{@link module:Collections.each}, this function applies iteratee to each item
|
||||
* in series and therefore the iteratee functions will complete in order.
|
||||
|
||||
* @name eachSeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.each]{@link module:Collections.each}
|
||||
* @alias forEachSeries
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to each
|
||||
* item in `coll`.
|
||||
* The array index is not passed to the iteratee.
|
||||
* If you need the index, use `eachOfSeries`.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all
|
||||
* `iteratee` functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function eachSeries(coll, iteratee, callback) {
|
||||
return (0, _eachLimit2.default)(coll, 1, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(eachSeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,67 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = ensureAsync;
|
||||
|
||||
var _setImmediate = require('./internal/setImmediate.js');
|
||||
|
||||
var _setImmediate2 = _interopRequireDefault(_setImmediate);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Wrap an async function and ensure it calls its callback on a later tick of
|
||||
* the event loop. If the function already calls its callback on a next tick,
|
||||
* no extra deferral is added. This is useful for preventing stack overflows
|
||||
* (`RangeError: Maximum call stack size exceeded`) and generally keeping
|
||||
* [Zalgo](http://blog.izs.me/post/59142742143/designing-apis-for-asynchrony)
|
||||
* contained. ES2017 `async` functions are returned as-is -- they are immune
|
||||
* to Zalgo's corrupting influences, as they always resolve on a later tick.
|
||||
*
|
||||
* @name ensureAsync
|
||||
* @static
|
||||
* @memberOf module:Utils
|
||||
* @method
|
||||
* @category Util
|
||||
* @param {AsyncFunction} fn - an async function, one that expects a node-style
|
||||
* callback as its last argument.
|
||||
* @returns {AsyncFunction} Returns a wrapped function with the exact same call
|
||||
* signature as the function passed in.
|
||||
* @example
|
||||
*
|
||||
* function sometimesAsync(arg, callback) {
|
||||
* if (cache[arg]) {
|
||||
* return callback(null, cache[arg]); // this would be synchronous!!
|
||||
* } else {
|
||||
* doSomeIO(arg, callback); // this IO would be asynchronous
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* // this has a risk of stack overflows if many results are cached in a row
|
||||
* async.mapSeries(args, sometimesAsync, done);
|
||||
*
|
||||
* // this will defer sometimesAsync's callback if necessary,
|
||||
* // preventing stack overflows
|
||||
* async.mapSeries(args, async.ensureAsync(sometimesAsync), done);
|
||||
*/
|
||||
function ensureAsync(fn) {
|
||||
if ((0, _wrapAsync.isAsync)(fn)) return fn;
|
||||
return function (...args /*, callback*/) {
|
||||
var callback = args.pop();
|
||||
var sync = true;
|
||||
args.push((...innerArgs) => {
|
||||
if (sync) {
|
||||
(0, _setImmediate2.default)(() => callback(...innerArgs));
|
||||
} else {
|
||||
callback(...innerArgs);
|
||||
}
|
||||
});
|
||||
fn.apply(this, args);
|
||||
sync = false;
|
||||
};
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,119 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOf = require('./eachOf.js');
|
||||
|
||||
var _eachOf2 = _interopRequireDefault(_eachOf);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Returns `true` if every element in `coll` satisfies an async test. If any
|
||||
* iteratee call returns `false`, the main `callback` is immediately called.
|
||||
*
|
||||
* @name every
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias all
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async truth test to apply to each item
|
||||
* in the collection in parallel.
|
||||
* The iteratee must complete with a boolean result value.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Result will be either `true` or `false`
|
||||
* depending on the values of the async tests. Invoked with (err, result).
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
* @example
|
||||
*
|
||||
* // dir1 is a directory that contains file1.txt, file2.txt
|
||||
* // dir2 is a directory that contains file3.txt, file4.txt
|
||||
* // dir3 is a directory that contains file5.txt
|
||||
* // dir4 does not exist
|
||||
*
|
||||
* const fileList = ['dir1/file1.txt','dir2/file3.txt','dir3/file5.txt'];
|
||||
* const withMissingFileList = ['file1.txt','file2.txt','file4.txt'];
|
||||
*
|
||||
* // asynchronous function that checks if a file exists
|
||||
* function fileExists(file, callback) {
|
||||
* fs.access(file, fs.constants.F_OK, (err) => {
|
||||
* callback(null, !err);
|
||||
* });
|
||||
* }
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.every(fileList, fileExists, function(err, result) {
|
||||
* console.log(result);
|
||||
* // true
|
||||
* // result is true since every file exists
|
||||
* });
|
||||
*
|
||||
* async.every(withMissingFileList, fileExists, function(err, result) {
|
||||
* console.log(result);
|
||||
* // false
|
||||
* // result is false since NOT every file exists
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.every(fileList, fileExists)
|
||||
* .then( result => {
|
||||
* console.log(result);
|
||||
* // true
|
||||
* // result is true since every file exists
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* async.every(withMissingFileList, fileExists)
|
||||
* .then( result => {
|
||||
* console.log(result);
|
||||
* // false
|
||||
* // result is false since NOT every file exists
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.every(fileList, fileExists);
|
||||
* console.log(result);
|
||||
* // true
|
||||
* // result is true since every file exists
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.every(withMissingFileList, fileExists);
|
||||
* console.log(result);
|
||||
* // false
|
||||
* // result is false since NOT every file exists
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function every(coll, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => !bool, res => !res)(_eachOf2.default, coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(every, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,46 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOfLimit = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`every`]{@link module:Collections.every} but runs a maximum of `limit` async operations at a time.
|
||||
*
|
||||
* @name everyLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.every]{@link module:Collections.every}
|
||||
* @alias allLimit
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - An async truth test to apply to each item
|
||||
* in the collection in parallel.
|
||||
* The iteratee must complete with a boolean result value.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Result will be either `true` or `false`
|
||||
* depending on the values of the async tests. Invoked with (err, result).
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
*/
|
||||
function everyLimit(coll, limit, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => !bool, res => !res)((0, _eachOfLimit2.default)(limit), coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(everyLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,45 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOfSeries = require('./eachOfSeries.js');
|
||||
|
||||
var _eachOfSeries2 = _interopRequireDefault(_eachOfSeries);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`every`]{@link module:Collections.every} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name everySeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.every]{@link module:Collections.every}
|
||||
* @alias allSeries
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async truth test to apply to each item
|
||||
* in the collection in series.
|
||||
* The iteratee must complete with a boolean result value.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Result will be either `true` or `false`
|
||||
* depending on the values of the async tests. Invoked with (err, result).
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
*/
|
||||
function everySeries(coll, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => !bool, res => !res)(_eachOfSeries2.default, coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(everySeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,93 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _filter2 = require('./internal/filter.js');
|
||||
|
||||
var _filter3 = _interopRequireDefault(_filter2);
|
||||
|
||||
var _eachOf = require('./eachOf.js');
|
||||
|
||||
var _eachOf2 = _interopRequireDefault(_eachOf);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Returns a new array of all the values in `coll` which pass an async truth
|
||||
* test. This operation is performed in parallel, but the results array will be
|
||||
* in the same order as the original.
|
||||
*
|
||||
* @name filter
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias select
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {Function} iteratee - A truth test to apply to each item in `coll`.
|
||||
* The `iteratee` is passed a `callback(err, truthValue)`, which must be called
|
||||
* with a boolean argument once it has completed. Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Invoked with (err, results).
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
* @example
|
||||
*
|
||||
* // dir1 is a directory that contains file1.txt, file2.txt
|
||||
* // dir2 is a directory that contains file3.txt, file4.txt
|
||||
* // dir3 is a directory that contains file5.txt
|
||||
*
|
||||
* const files = ['dir1/file1.txt','dir2/file3.txt','dir3/file6.txt'];
|
||||
*
|
||||
* // asynchronous function that checks if a file exists
|
||||
* function fileExists(file, callback) {
|
||||
* fs.access(file, fs.constants.F_OK, (err) => {
|
||||
* callback(null, !err);
|
||||
* });
|
||||
* }
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.filter(files, fileExists, function(err, results) {
|
||||
* if(err) {
|
||||
* console.log(err);
|
||||
* } else {
|
||||
* console.log(results);
|
||||
* // [ 'dir1/file1.txt', 'dir2/file3.txt' ]
|
||||
* // results is now an array of the existing files
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.filter(files, fileExists)
|
||||
* .then(results => {
|
||||
* console.log(results);
|
||||
* // [ 'dir1/file1.txt', 'dir2/file3.txt' ]
|
||||
* // results is now an array of the existing files
|
||||
* }).catch(err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let results = await async.filter(files, fileExists);
|
||||
* console.log(results);
|
||||
* // [ 'dir1/file1.txt', 'dir2/file3.txt' ]
|
||||
* // results is now an array of the existing files
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function filter(coll, iteratee, callback) {
|
||||
return (0, _filter3.default)(_eachOf2.default, coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(filter, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,45 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _filter2 = require('./internal/filter.js');
|
||||
|
||||
var _filter3 = _interopRequireDefault(_filter2);
|
||||
|
||||
var _eachOfLimit = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`filter`]{@link module:Collections.filter} but runs a maximum of `limit` async operations at a
|
||||
* time.
|
||||
*
|
||||
* @name filterLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.filter]{@link module:Collections.filter}
|
||||
* @alias selectLimit
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {Function} iteratee - A truth test to apply to each item in `coll`.
|
||||
* The `iteratee` is passed a `callback(err, truthValue)`, which must be called
|
||||
* with a boolean argument once it has completed. Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Invoked with (err, results).
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
*/
|
||||
function filterLimit(coll, limit, iteratee, callback) {
|
||||
return (0, _filter3.default)((0, _eachOfLimit2.default)(limit), coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(filterLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,43 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _filter2 = require('./internal/filter.js');
|
||||
|
||||
var _filter3 = _interopRequireDefault(_filter2);
|
||||
|
||||
var _eachOfSeries = require('./eachOfSeries.js');
|
||||
|
||||
var _eachOfSeries2 = _interopRequireDefault(_eachOfSeries);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`filter`]{@link module:Collections.filter} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name filterSeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.filter]{@link module:Collections.filter}
|
||||
* @alias selectSeries
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {Function} iteratee - A truth test to apply to each item in `coll`.
|
||||
* The `iteratee` is passed a `callback(err, truthValue)`, which must be called
|
||||
* with a boolean argument once it has completed. Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Invoked with (err, results)
|
||||
* @returns {Promise} a promise, if no callback provided
|
||||
*/
|
||||
function filterSeries(coll, iteratee, callback) {
|
||||
return (0, _filter3.default)(_eachOfSeries2.default, coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(filterSeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,96 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOf = require('./eachOf.js');
|
||||
|
||||
var _eachOf2 = _interopRequireDefault(_eachOf);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Returns the first value in `coll` that passes an async truth test. The
|
||||
* `iteratee` is applied in parallel, meaning the first iteratee to return
|
||||
* `true` will fire the detect `callback` with that result. That means the
|
||||
* result might not be the first item in the original `coll` (in terms of order)
|
||||
* that passes the test.
|
||||
|
||||
* If order within the original `coll` is important, then look at
|
||||
* [`detectSeries`]{@link module:Collections.detectSeries}.
|
||||
*
|
||||
* @name detect
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias find
|
||||
* @category Collections
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - A truth test to apply to each item in `coll`.
|
||||
* The iteratee must complete with a boolean value as its result.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called as soon as any
|
||||
* iteratee returns `true`, or after all the `iteratee` functions have finished.
|
||||
* Result will be the first item in the array that passes the truth test
|
||||
* (iteratee) or the value `undefined` if none passed. Invoked with
|
||||
* (err, result).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
* @example
|
||||
*
|
||||
* // dir1 is a directory that contains file1.txt, file2.txt
|
||||
* // dir2 is a directory that contains file3.txt, file4.txt
|
||||
* // dir3 is a directory that contains file5.txt
|
||||
*
|
||||
* // asynchronous function that checks if a file exists
|
||||
* function fileExists(file, callback) {
|
||||
* fs.access(file, fs.constants.F_OK, (err) => {
|
||||
* callback(null, !err);
|
||||
* });
|
||||
* }
|
||||
*
|
||||
* async.detect(['file3.txt','file2.txt','dir1/file1.txt'], fileExists,
|
||||
* function(err, result) {
|
||||
* console.log(result);
|
||||
* // dir1/file1.txt
|
||||
* // result now equals the first file in the list that exists
|
||||
* }
|
||||
*);
|
||||
*
|
||||
* // Using Promises
|
||||
* async.detect(['file3.txt','file2.txt','dir1/file1.txt'], fileExists)
|
||||
* .then(result => {
|
||||
* console.log(result);
|
||||
* // dir1/file1.txt
|
||||
* // result now equals the first file in the list that exists
|
||||
* }).catch(err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.detect(['file3.txt','file2.txt','dir1/file1.txt'], fileExists);
|
||||
* console.log(result);
|
||||
* // dir1/file1.txt
|
||||
* // result now equals the file in the list that exists
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function detect(coll, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => bool, (res, item) => item)(_eachOf2.default, coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(detect, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,48 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOfLimit = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`detect`]{@link module:Collections.detect} but runs a maximum of `limit` async operations at a
|
||||
* time.
|
||||
*
|
||||
* @name detectLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.detect]{@link module:Collections.detect}
|
||||
* @alias findLimit
|
||||
* @category Collections
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - A truth test to apply to each item in `coll`.
|
||||
* The iteratee must complete with a boolean value as its result.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called as soon as any
|
||||
* iteratee returns `true`, or after all the `iteratee` functions have finished.
|
||||
* Result will be the first item in the array that passes the truth test
|
||||
* (iteratee) or the value `undefined` if none passed. Invoked with
|
||||
* (err, result).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function detectLimit(coll, limit, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => bool, (res, item) => item)((0, _eachOfLimit2.default)(limit), coll, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(detectLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,47 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _createTester = require('./internal/createTester.js');
|
||||
|
||||
var _createTester2 = _interopRequireDefault(_createTester);
|
||||
|
||||
var _eachOfLimit = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`detect`]{@link module:Collections.detect} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name detectSeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.detect]{@link module:Collections.detect}
|
||||
* @alias findSeries
|
||||
* @category Collections
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - A truth test to apply to each item in `coll`.
|
||||
* The iteratee must complete with a boolean value as its result.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called as soon as any
|
||||
* iteratee returns `true`, or after all the `iteratee` functions have finished.
|
||||
* Result will be the first item in the array that passes the truth test
|
||||
* (iteratee) or the value `undefined` if none passed. Invoked with
|
||||
* (err, result).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function detectSeries(coll, iteratee, callback) {
|
||||
return (0, _createTester2.default)(bool => bool, (res, item) => item)((0, _eachOfLimit2.default)(1), coll, iteratee, callback);
|
||||
}
|
||||
|
||||
exports.default = (0, _awaitify2.default)(detectSeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,115 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _concatLimit = require('./concatLimit.js');
|
||||
|
||||
var _concatLimit2 = _interopRequireDefault(_concatLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Applies `iteratee` to each item in `coll`, concatenating the results. Returns
|
||||
* the concatenated list. The `iteratee`s are called in parallel, and the
|
||||
* results are concatenated as they return. The results array will be returned in
|
||||
* the original order of `coll` passed to the `iteratee` function.
|
||||
*
|
||||
* @name concat
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @category Collection
|
||||
* @alias flatMap
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - A function to apply to each item in `coll`,
|
||||
* which should use an array as its result. Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished, or an error occurs. Results is an array
|
||||
* containing the concatenated results of the `iteratee` function. Invoked with
|
||||
* (err, results).
|
||||
* @returns A Promise, if no callback is passed
|
||||
* @example
|
||||
*
|
||||
* // dir1 is a directory that contains file1.txt, file2.txt
|
||||
* // dir2 is a directory that contains file3.txt, file4.txt
|
||||
* // dir3 is a directory that contains file5.txt
|
||||
* // dir4 does not exist
|
||||
*
|
||||
* let directoryList = ['dir1','dir2','dir3'];
|
||||
* let withMissingDirectoryList = ['dir1','dir2','dir3', 'dir4'];
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.concat(directoryList, fs.readdir, function(err, results) {
|
||||
* if (err) {
|
||||
* console.log(err);
|
||||
* } else {
|
||||
* console.log(results);
|
||||
* // [ 'file1.txt', 'file2.txt', 'file3.txt', 'file4.txt', file5.txt ]
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.concat(withMissingDirectoryList, fs.readdir, function(err, results) {
|
||||
* if (err) {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4 does not exist
|
||||
* } else {
|
||||
* console.log(results);
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.concat(directoryList, fs.readdir)
|
||||
* .then(results => {
|
||||
* console.log(results);
|
||||
* // [ 'file1.txt', 'file2.txt', 'file3.txt', 'file4.txt', file5.txt ]
|
||||
* }).catch(err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.concat(withMissingDirectoryList, fs.readdir)
|
||||
* .then(results => {
|
||||
* console.log(results);
|
||||
* }).catch(err => {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4 does not exist
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let results = await async.concat(directoryList, fs.readdir);
|
||||
* console.log(results);
|
||||
* // [ 'file1.txt', 'file2.txt', 'file3.txt', 'file4.txt', file5.txt ]
|
||||
* } catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* // Error Handling
|
||||
* async () => {
|
||||
* try {
|
||||
* let results = await async.concat(withMissingDirectoryList, fs.readdir);
|
||||
* console.log(results);
|
||||
* } catch (err) {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4 does not exist
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function concat(coll, iteratee, callback) {
|
||||
return (0, _concatLimit2.default)(coll, Infinity, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(concat, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,60 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _mapLimit = require('./mapLimit.js');
|
||||
|
||||
var _mapLimit2 = _interopRequireDefault(_mapLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`concat`]{@link module:Collections.concat} but runs a maximum of `limit` async operations at a time.
|
||||
*
|
||||
* @name concatLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.concat]{@link module:Collections.concat}
|
||||
* @category Collection
|
||||
* @alias flatMapLimit
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - A function to apply to each item in `coll`,
|
||||
* which should use an array as its result. Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished, or an error occurs. Results is an array
|
||||
* containing the concatenated results of the `iteratee` function. Invoked with
|
||||
* (err, results).
|
||||
* @returns A Promise, if no callback is passed
|
||||
*/
|
||||
function concatLimit(coll, limit, iteratee, callback) {
|
||||
var _iteratee = (0, _wrapAsync2.default)(iteratee);
|
||||
return (0, _mapLimit2.default)(coll, limit, (val, iterCb) => {
|
||||
_iteratee(val, (err, ...args) => {
|
||||
if (err) return iterCb(err);
|
||||
return iterCb(err, args);
|
||||
});
|
||||
}, (err, mapResults) => {
|
||||
var result = [];
|
||||
for (var i = 0; i < mapResults.length; i++) {
|
||||
if (mapResults[i]) {
|
||||
result = result.concat(...mapResults[i]);
|
||||
}
|
||||
}
|
||||
|
||||
return callback(err, result);
|
||||
});
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(concatLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,41 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _concatLimit = require('./concatLimit.js');
|
||||
|
||||
var _concatLimit2 = _interopRequireDefault(_concatLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`concat`]{@link module:Collections.concat} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name concatSeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.concat]{@link module:Collections.concat}
|
||||
* @category Collection
|
||||
* @alias flatMapSeries
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - A function to apply to each item in `coll`.
|
||||
* The iteratee should complete with an array an array of results.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished, or an error occurs. Results is an array
|
||||
* containing the concatenated results of the `iteratee` function. Invoked with
|
||||
* (err, results).
|
||||
* @returns A Promise, if no callback is passed
|
||||
*/
|
||||
function concatSeries(coll, iteratee, callback) {
|
||||
return (0, _concatLimit2.default)(coll, 1, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(concatSeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,153 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachOfSeries = require('./eachOfSeries.js');
|
||||
|
||||
var _eachOfSeries2 = _interopRequireDefault(_eachOfSeries);
|
||||
|
||||
var _once = require('./internal/once.js');
|
||||
|
||||
var _once2 = _interopRequireDefault(_once);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Reduces `coll` into a single value using an async `iteratee` to return each
|
||||
* successive step. `memo` is the initial state of the reduction. This function
|
||||
* only operates in series.
|
||||
*
|
||||
* For performance reasons, it may make sense to split a call to this function
|
||||
* into a parallel map, and then use the normal `Array.prototype.reduce` on the
|
||||
* results. This function is for situations where each step in the reduction
|
||||
* needs to be async; if you can get the data before reducing it, then it's
|
||||
* probably a good idea to do so.
|
||||
*
|
||||
* @name reduce
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias inject
|
||||
* @alias foldl
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {*} memo - The initial state of the reduction.
|
||||
* @param {AsyncFunction} iteratee - A function applied to each item in the
|
||||
* array to produce the next step in the reduction.
|
||||
* The `iteratee` should complete with the next state of the reduction.
|
||||
* If the iteratee completes with an error, the reduction is stopped and the
|
||||
* main `callback` is immediately called with the error.
|
||||
* Invoked with (memo, item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Result is the reduced value. Invoked with
|
||||
* (err, result).
|
||||
* @returns {Promise} a promise, if no callback is passed
|
||||
* @example
|
||||
*
|
||||
* // file1.txt is a file that is 1000 bytes in size
|
||||
* // file2.txt is a file that is 2000 bytes in size
|
||||
* // file3.txt is a file that is 3000 bytes in size
|
||||
* // file4.txt does not exist
|
||||
*
|
||||
* const fileList = ['file1.txt','file2.txt','file3.txt'];
|
||||
* const withMissingFileList = ['file1.txt','file2.txt','file3.txt', 'file4.txt'];
|
||||
*
|
||||
* // asynchronous function that computes the file size in bytes
|
||||
* // file size is added to the memoized value, then returned
|
||||
* function getFileSizeInBytes(memo, file, callback) {
|
||||
* fs.stat(file, function(err, stat) {
|
||||
* if (err) {
|
||||
* return callback(err);
|
||||
* }
|
||||
* callback(null, memo + stat.size);
|
||||
* });
|
||||
* }
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.reduce(fileList, 0, getFileSizeInBytes, function(err, result) {
|
||||
* if (err) {
|
||||
* console.log(err);
|
||||
* } else {
|
||||
* console.log(result);
|
||||
* // 6000
|
||||
* // which is the sum of the file sizes of the three files
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.reduce(withMissingFileList, 0, getFileSizeInBytes, function(err, result) {
|
||||
* if (err) {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* } else {
|
||||
* console.log(result);
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.reduce(fileList, 0, getFileSizeInBytes)
|
||||
* .then( result => {
|
||||
* console.log(result);
|
||||
* // 6000
|
||||
* // which is the sum of the file sizes of the three files
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.reduce(withMissingFileList, 0, getFileSizeInBytes)
|
||||
* .then( result => {
|
||||
* console.log(result);
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.reduce(fileList, 0, getFileSizeInBytes);
|
||||
* console.log(result);
|
||||
* // 6000
|
||||
* // which is the sum of the file sizes of the three files
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* // Error Handling
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.reduce(withMissingFileList, 0, getFileSizeInBytes);
|
||||
* console.log(result);
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function reduce(coll, memo, iteratee, callback) {
|
||||
callback = (0, _once2.default)(callback);
|
||||
var _iteratee = (0, _wrapAsync2.default)(iteratee);
|
||||
return (0, _eachOfSeries2.default)(coll, (x, i, iterCb) => {
|
||||
_iteratee(memo, x, (err, v) => {
|
||||
memo = v;
|
||||
iterCb(err);
|
||||
});
|
||||
}, err => callback(err, memo));
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(reduce, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,41 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = reduceRight;
|
||||
|
||||
var _reduce = require('./reduce.js');
|
||||
|
||||
var _reduce2 = _interopRequireDefault(_reduce);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Same as [`reduce`]{@link module:Collections.reduce}, only operates on `array` in reverse order.
|
||||
*
|
||||
* @name reduceRight
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.reduce]{@link module:Collections.reduce}
|
||||
* @alias foldr
|
||||
* @category Collection
|
||||
* @param {Array} array - A collection to iterate over.
|
||||
* @param {*} memo - The initial state of the reduction.
|
||||
* @param {AsyncFunction} iteratee - A function applied to each item in the
|
||||
* array to produce the next step in the reduction.
|
||||
* The `iteratee` should complete with the next state of the reduction.
|
||||
* If the iteratee completes with an error, the reduction is stopped and the
|
||||
* main `callback` is immediately called with the error.
|
||||
* Invoked with (memo, item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Result is the reduced value. Invoked with
|
||||
* (err, result).
|
||||
* @returns {Promise} a promise, if no callback is passed
|
||||
*/
|
||||
function reduceRight(array, memo, iteratee, callback) {
|
||||
var reversed = [...array].reverse();
|
||||
return (0, _reduce2.default)(reversed, memo, iteratee, callback);
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,129 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachOf = require('./eachOf.js');
|
||||
|
||||
var _eachOf2 = _interopRequireDefault(_eachOf);
|
||||
|
||||
var _withoutIndex = require('./internal/withoutIndex.js');
|
||||
|
||||
var _withoutIndex2 = _interopRequireDefault(_withoutIndex);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Applies the function `iteratee` to each item in `coll`, in parallel.
|
||||
* The `iteratee` is called with an item from the list, and a callback for when
|
||||
* it has finished. If the `iteratee` passes an error to its `callback`, the
|
||||
* main `callback` (for the `each` function) is immediately called with the
|
||||
* error.
|
||||
*
|
||||
* Note, that since this function applies `iteratee` to each item in parallel,
|
||||
* there is no guarantee that the iteratee functions will complete in order.
|
||||
*
|
||||
* @name each
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias forEach
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to
|
||||
* each item in `coll`. Invoked with (item, callback).
|
||||
* The array index is not passed to the iteratee.
|
||||
* If you need the index, use `eachOf`.
|
||||
* @param {Function} [callback] - A callback which is called when all
|
||||
* `iteratee` functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
* @example
|
||||
*
|
||||
* // dir1 is a directory that contains file1.txt, file2.txt
|
||||
* // dir2 is a directory that contains file3.txt, file4.txt
|
||||
* // dir3 is a directory that contains file5.txt
|
||||
* // dir4 does not exist
|
||||
*
|
||||
* const fileList = [ 'dir1/file2.txt', 'dir2/file3.txt', 'dir/file5.txt'];
|
||||
* const withMissingFileList = ['dir1/file1.txt', 'dir4/file2.txt'];
|
||||
*
|
||||
* // asynchronous function that deletes a file
|
||||
* const deleteFile = function(file, callback) {
|
||||
* fs.unlink(file, callback);
|
||||
* };
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.each(fileList, deleteFile, function(err) {
|
||||
* if( err ) {
|
||||
* console.log(err);
|
||||
* } else {
|
||||
* console.log('All files have been deleted successfully');
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.each(withMissingFileList, deleteFile, function(err){
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4/file2.txt does not exist
|
||||
* // dir1/file1.txt could have been deleted
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.each(fileList, deleteFile)
|
||||
* .then( () => {
|
||||
* console.log('All files have been deleted successfully');
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.each(fileList, deleteFile)
|
||||
* .then( () => {
|
||||
* console.log('All files have been deleted successfully');
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4/file2.txt does not exist
|
||||
* // dir1/file1.txt could have been deleted
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* await async.each(files, deleteFile);
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* // Error Handling
|
||||
* async () => {
|
||||
* try {
|
||||
* await async.each(withMissingFileList, deleteFile);
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* // since dir4/file2.txt does not exist
|
||||
* // dir1/file1.txt could have been deleted
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function eachLimit(coll, iteratee, callback) {
|
||||
return (0, _eachOf2.default)(coll, (0, _withoutIndex2.default)((0, _wrapAsync2.default)(iteratee)), callback);
|
||||
}
|
||||
|
||||
exports.default = (0, _awaitify2.default)(eachLimit, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,50 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachOfLimit = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _withoutIndex = require('./internal/withoutIndex.js');
|
||||
|
||||
var _withoutIndex2 = _interopRequireDefault(_withoutIndex);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`each`]{@link module:Collections.each} but runs a maximum of `limit` async operations at a time.
|
||||
*
|
||||
* @name eachLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.each]{@link module:Collections.each}
|
||||
* @alias forEachLimit
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to each item in
|
||||
* `coll`.
|
||||
* The array index is not passed to the iteratee.
|
||||
* If you need the index, use `eachOfLimit`.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all
|
||||
* `iteratee` functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function eachLimit(coll, limit, iteratee, callback) {
|
||||
return (0, _eachOfLimit2.default)(limit)(coll, (0, _withoutIndex2.default)((0, _wrapAsync2.default)(iteratee)), callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(eachLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,185 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _isArrayLike = require('./internal/isArrayLike.js');
|
||||
|
||||
var _isArrayLike2 = _interopRequireDefault(_isArrayLike);
|
||||
|
||||
var _breakLoop = require('./internal/breakLoop.js');
|
||||
|
||||
var _breakLoop2 = _interopRequireDefault(_breakLoop);
|
||||
|
||||
var _eachOfLimit = require('./eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _once = require('./internal/once.js');
|
||||
|
||||
var _once2 = _interopRequireDefault(_once);
|
||||
|
||||
var _onlyOnce = require('./internal/onlyOnce.js');
|
||||
|
||||
var _onlyOnce2 = _interopRequireDefault(_onlyOnce);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
// eachOf implementation optimized for array-likes
|
||||
function eachOfArrayLike(coll, iteratee, callback) {
|
||||
callback = (0, _once2.default)(callback);
|
||||
var index = 0,
|
||||
completed = 0,
|
||||
{ length } = coll,
|
||||
canceled = false;
|
||||
if (length === 0) {
|
||||
callback(null);
|
||||
}
|
||||
|
||||
function iteratorCallback(err, value) {
|
||||
if (err === false) {
|
||||
canceled = true;
|
||||
}
|
||||
if (canceled === true) return;
|
||||
if (err) {
|
||||
callback(err);
|
||||
} else if (++completed === length || value === _breakLoop2.default) {
|
||||
callback(null);
|
||||
}
|
||||
}
|
||||
|
||||
for (; index < length; index++) {
|
||||
iteratee(coll[index], index, (0, _onlyOnce2.default)(iteratorCallback));
|
||||
}
|
||||
}
|
||||
|
||||
// a generic version of eachOf which can handle array, object, and iterator cases.
|
||||
function eachOfGeneric(coll, iteratee, callback) {
|
||||
return (0, _eachOfLimit2.default)(coll, Infinity, iteratee, callback);
|
||||
}
|
||||
|
||||
/**
|
||||
* Like [`each`]{@link module:Collections.each}, except that it passes the key (or index) as the second argument
|
||||
* to the iteratee.
|
||||
*
|
||||
* @name eachOf
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias forEachOf
|
||||
* @category Collection
|
||||
* @see [async.each]{@link module:Collections.each}
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - A function to apply to each
|
||||
* item in `coll`.
|
||||
* The `key` is the item's key, or index in the case of an array.
|
||||
* Invoked with (item, key, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all
|
||||
* `iteratee` functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
* @example
|
||||
*
|
||||
* // dev.json is a file containing a valid json object config for dev environment
|
||||
* // dev.json is a file containing a valid json object config for test environment
|
||||
* // prod.json is a file containing a valid json object config for prod environment
|
||||
* // invalid.json is a file with a malformed json object
|
||||
*
|
||||
* let configs = {}; //global variable
|
||||
* let validConfigFileMap = {dev: 'dev.json', test: 'test.json', prod: 'prod.json'};
|
||||
* let invalidConfigFileMap = {dev: 'dev.json', test: 'test.json', invalid: 'invalid.json'};
|
||||
*
|
||||
* // asynchronous function that reads a json file and parses the contents as json object
|
||||
* function parseFile(file, key, callback) {
|
||||
* fs.readFile(file, "utf8", function(err, data) {
|
||||
* if (err) return calback(err);
|
||||
* try {
|
||||
* configs[key] = JSON.parse(data);
|
||||
* } catch (e) {
|
||||
* return callback(e);
|
||||
* }
|
||||
* callback();
|
||||
* });
|
||||
* }
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.forEachOf(validConfigFileMap, parseFile, function (err) {
|
||||
* if (err) {
|
||||
* console.error(err);
|
||||
* } else {
|
||||
* console.log(configs);
|
||||
* // configs is now a map of JSON data, e.g.
|
||||
* // { dev: //parsed dev.json, test: //parsed test.json, prod: //parsed prod.json}
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* //Error handing
|
||||
* async.forEachOf(invalidConfigFileMap, parseFile, function (err) {
|
||||
* if (err) {
|
||||
* console.error(err);
|
||||
* // JSON parse error exception
|
||||
* } else {
|
||||
* console.log(configs);
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.forEachOf(validConfigFileMap, parseFile)
|
||||
* .then( () => {
|
||||
* console.log(configs);
|
||||
* // configs is now a map of JSON data, e.g.
|
||||
* // { dev: //parsed dev.json, test: //parsed test.json, prod: //parsed prod.json}
|
||||
* }).catch( err => {
|
||||
* console.error(err);
|
||||
* });
|
||||
*
|
||||
* //Error handing
|
||||
* async.forEachOf(invalidConfigFileMap, parseFile)
|
||||
* .then( () => {
|
||||
* console.log(configs);
|
||||
* }).catch( err => {
|
||||
* console.error(err);
|
||||
* // JSON parse error exception
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.forEachOf(validConfigFileMap, parseFile);
|
||||
* console.log(configs);
|
||||
* // configs is now a map of JSON data, e.g.
|
||||
* // { dev: //parsed dev.json, test: //parsed test.json, prod: //parsed prod.json}
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* //Error handing
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.forEachOf(invalidConfigFileMap, parseFile);
|
||||
* console.log(configs);
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* // JSON parse error exception
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function eachOf(coll, iteratee, callback) {
|
||||
var eachOfImplementation = (0, _isArrayLike2.default)(coll) ? eachOfArrayLike : eachOfGeneric;
|
||||
return eachOfImplementation(coll, (0, _wrapAsync2.default)(iteratee), callback);
|
||||
}
|
||||
|
||||
exports.default = (0, _awaitify2.default)(eachOf, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,47 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachOfLimit2 = require('./internal/eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit3 = _interopRequireDefault(_eachOfLimit2);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`eachOf`]{@link module:Collections.eachOf} but runs a maximum of `limit` async operations at a
|
||||
* time.
|
||||
*
|
||||
* @name eachOfLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.eachOf]{@link module:Collections.eachOf}
|
||||
* @alias forEachOfLimit
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to each
|
||||
* item in `coll`. The `key` is the item's key, or index in the case of an
|
||||
* array.
|
||||
* Invoked with (item, key, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all
|
||||
* `iteratee` functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function eachOfLimit(coll, limit, iteratee, callback) {
|
||||
return (0, _eachOfLimit3.default)(limit)(coll, (0, _wrapAsync2.default)(iteratee), callback);
|
||||
}
|
||||
|
||||
exports.default = (0, _awaitify2.default)(eachOfLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,39 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachOfLimit = require('./eachOfLimit.js');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`eachOf`]{@link module:Collections.eachOf} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name eachOfSeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.eachOf]{@link module:Collections.eachOf}
|
||||
* @alias forEachOfSeries
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to each item in
|
||||
* `coll`.
|
||||
* Invoked with (item, key, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all `iteratee`
|
||||
* functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function eachOfSeries(coll, iteratee, callback) {
|
||||
return (0, _eachOfLimit2.default)(coll, 1, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(eachOfSeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,44 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachLimit = require('./eachLimit.js');
|
||||
|
||||
var _eachLimit2 = _interopRequireDefault(_eachLimit);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`each`]{@link module:Collections.each} but runs only a single async operation at a time.
|
||||
*
|
||||
* Note, that unlike [`each`]{@link module:Collections.each}, this function applies iteratee to each item
|
||||
* in series and therefore the iteratee functions will complete in order.
|
||||
|
||||
* @name eachSeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.each]{@link module:Collections.each}
|
||||
* @alias forEachSeries
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to each
|
||||
* item in `coll`.
|
||||
* The array index is not passed to the iteratee.
|
||||
* If you need the index, use `eachOfSeries`.
|
||||
* Invoked with (item, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all
|
||||
* `iteratee` functions have finished, or an error occurs. Invoked with (err).
|
||||
* @returns {Promise} a promise, if a callback is omitted
|
||||
*/
|
||||
function eachSeries(coll, iteratee, callback) {
|
||||
return (0, _eachLimit2.default)(coll, 1, iteratee, callback);
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(eachSeries, 3);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,68 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _onlyOnce = require('./internal/onlyOnce.js');
|
||||
|
||||
var _onlyOnce2 = _interopRequireDefault(_onlyOnce);
|
||||
|
||||
var _ensureAsync = require('./ensureAsync.js');
|
||||
|
||||
var _ensureAsync2 = _interopRequireDefault(_ensureAsync);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Calls the asynchronous function `fn` with a callback parameter that allows it
|
||||
* to call itself again, in series, indefinitely.
|
||||
|
||||
* If an error is passed to the callback then `errback` is called with the
|
||||
* error, and execution stops, otherwise it will never be called.
|
||||
*
|
||||
* @name forever
|
||||
* @static
|
||||
* @memberOf module:ControlFlow
|
||||
* @method
|
||||
* @category Control Flow
|
||||
* @param {AsyncFunction} fn - an async function to call repeatedly.
|
||||
* Invoked with (next).
|
||||
* @param {Function} [errback] - when `fn` passes an error to it's callback,
|
||||
* this function will be called, and execution stops. Invoked with (err).
|
||||
* @returns {Promise} a promise that rejects if an error occurs and an errback
|
||||
* is not passed
|
||||
* @example
|
||||
*
|
||||
* async.forever(
|
||||
* function(next) {
|
||||
* // next is suitable for passing to things that need a callback(err [, whatever]);
|
||||
* // it will result in this function being called again.
|
||||
* },
|
||||
* function(err) {
|
||||
* // if next is called with a value in its first parameter, it will appear
|
||||
* // in here as 'err', and execution will stop.
|
||||
* }
|
||||
* );
|
||||
*/
|
||||
function forever(fn, errback) {
|
||||
var done = (0, _onlyOnce2.default)(errback);
|
||||
var task = (0, _wrapAsync2.default)((0, _ensureAsync2.default)(fn));
|
||||
|
||||
function next(err) {
|
||||
if (err) return done(err);
|
||||
if (err === false) return;
|
||||
task(next);
|
||||
}
|
||||
return next();
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(forever, 2);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,108 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = groupBy;
|
||||
|
||||
var _groupByLimit = require('./groupByLimit.js');
|
||||
|
||||
var _groupByLimit2 = _interopRequireDefault(_groupByLimit);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Returns a new object, where each value corresponds to an array of items, from
|
||||
* `coll`, that returned the corresponding key. That is, the keys of the object
|
||||
* correspond to the values passed to the `iteratee` callback.
|
||||
*
|
||||
* Note: Since this function applies the `iteratee` to each item in parallel,
|
||||
* there is no guarantee that the `iteratee` functions will complete in order.
|
||||
* However, the values for each key in the `result` will be in the same order as
|
||||
* the original `coll`. For Objects, the values will roughly be in the order of
|
||||
* the original Objects' keys (but this can vary across JavaScript engines).
|
||||
*
|
||||
* @name groupBy
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to each item in
|
||||
* `coll`.
|
||||
* The iteratee should complete with a `key` to group the value under.
|
||||
* Invoked with (value, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all `iteratee`
|
||||
* functions have finished, or an error occurs. Result is an `Object` whoses
|
||||
* properties are arrays of values which returned the corresponding key.
|
||||
* @returns {Promise} a promise, if no callback is passed
|
||||
* @example
|
||||
*
|
||||
* // dir1 is a directory that contains file1.txt, file2.txt
|
||||
* // dir2 is a directory that contains file3.txt, file4.txt
|
||||
* // dir3 is a directory that contains file5.txt
|
||||
* // dir4 does not exist
|
||||
*
|
||||
* const files = ['dir1/file1.txt','dir2','dir4']
|
||||
*
|
||||
* // asynchronous function that detects file type as none, file, or directory
|
||||
* function detectFile(file, callback) {
|
||||
* fs.stat(file, function(err, stat) {
|
||||
* if (err) {
|
||||
* return callback(null, 'none');
|
||||
* }
|
||||
* callback(null, stat.isDirectory() ? 'directory' : 'file');
|
||||
* });
|
||||
* }
|
||||
*
|
||||
* //Using callbacks
|
||||
* async.groupBy(files, detectFile, function(err, result) {
|
||||
* if(err) {
|
||||
* console.log(err);
|
||||
* } else {
|
||||
* console.log(result);
|
||||
* // {
|
||||
* // file: [ 'dir1/file1.txt' ],
|
||||
* // none: [ 'dir4' ],
|
||||
* // directory: [ 'dir2']
|
||||
* // }
|
||||
* // result is object containing the files grouped by type
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.groupBy(files, detectFile)
|
||||
* .then( result => {
|
||||
* console.log(result);
|
||||
* // {
|
||||
* // file: [ 'dir1/file1.txt' ],
|
||||
* // none: [ 'dir4' ],
|
||||
* // directory: [ 'dir2']
|
||||
* // }
|
||||
* // result is object containing the files grouped by type
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.groupBy(files, detectFile);
|
||||
* console.log(result);
|
||||
* // {
|
||||
* // file: [ 'dir1/file1.txt' ],
|
||||
* // none: [ 'dir4' ],
|
||||
* // directory: [ 'dir2']
|
||||
* // }
|
||||
* // result is object containing the files grouped by type
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function groupBy(coll, iteratee, callback) {
|
||||
return (0, _groupByLimit2.default)(coll, Infinity, iteratee, callback);
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,71 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _mapLimit = require('./mapLimit.js');
|
||||
|
||||
var _mapLimit2 = _interopRequireDefault(_mapLimit);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`groupBy`]{@link module:Collections.groupBy} but runs a maximum of `limit` async operations at a time.
|
||||
*
|
||||
* @name groupByLimit
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.groupBy]{@link module:Collections.groupBy}
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {number} limit - The maximum number of async operations at a time.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to each item in
|
||||
* `coll`.
|
||||
* The iteratee should complete with a `key` to group the value under.
|
||||
* Invoked with (value, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all `iteratee`
|
||||
* functions have finished, or an error occurs. Result is an `Object` whoses
|
||||
* properties are arrays of values which returned the corresponding key.
|
||||
* @returns {Promise} a promise, if no callback is passed
|
||||
*/
|
||||
function groupByLimit(coll, limit, iteratee, callback) {
|
||||
var _iteratee = (0, _wrapAsync2.default)(iteratee);
|
||||
return (0, _mapLimit2.default)(coll, limit, (val, iterCb) => {
|
||||
_iteratee(val, (err, key) => {
|
||||
if (err) return iterCb(err);
|
||||
return iterCb(err, { key, val });
|
||||
});
|
||||
}, (err, mapResults) => {
|
||||
var result = {};
|
||||
// from MDN, handle object having an `hasOwnProperty` prop
|
||||
var { hasOwnProperty } = Object.prototype;
|
||||
|
||||
for (var i = 0; i < mapResults.length; i++) {
|
||||
if (mapResults[i]) {
|
||||
var { key } = mapResults[i];
|
||||
var { val } = mapResults[i];
|
||||
|
||||
if (hasOwnProperty.call(result, key)) {
|
||||
result[key].push(val);
|
||||
} else {
|
||||
result[key] = [val];
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return callback(err, result);
|
||||
});
|
||||
}
|
||||
|
||||
exports.default = (0, _awaitify2.default)(groupByLimit, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,36 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = groupBySeries;
|
||||
|
||||
var _groupByLimit = require('./groupByLimit.js');
|
||||
|
||||
var _groupByLimit2 = _interopRequireDefault(_groupByLimit);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* The same as [`groupBy`]{@link module:Collections.groupBy} but runs only a single async operation at a time.
|
||||
*
|
||||
* @name groupBySeries
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @see [async.groupBy]{@link module:Collections.groupBy}
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {AsyncFunction} iteratee - An async function to apply to each item in
|
||||
* `coll`.
|
||||
* The iteratee should complete with a `key` to group the value under.
|
||||
* Invoked with (value, callback).
|
||||
* @param {Function} [callback] - A callback which is called when all `iteratee`
|
||||
* functions have finished, or an error occurs. Result is an `Object` whose
|
||||
* properties are arrays of values which returned the corresponding key.
|
||||
* @returns {Promise} a promise, if no callback is passed
|
||||
*/
|
||||
function groupBySeries(coll, iteratee, callback) {
|
||||
return (0, _groupByLimit2.default)(coll, 1, iteratee, callback);
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,588 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.doDuring = exports.during = exports.wrapSync = undefined;
|
||||
exports.selectSeries = exports.selectLimit = exports.select = exports.foldr = exports.foldl = exports.inject = exports.forEachOfLimit = exports.forEachOfSeries = exports.forEachOf = exports.forEachLimit = exports.forEachSeries = exports.forEach = exports.flatMapSeries = exports.flatMapLimit = exports.flatMap = exports.findSeries = exports.findLimit = exports.find = exports.anySeries = exports.anyLimit = exports.any = exports.allSeries = exports.allLimit = exports.all = exports.whilst = exports.waterfall = exports.until = exports.unmemoize = exports.tryEach = exports.transform = exports.timesSeries = exports.timesLimit = exports.times = exports.timeout = exports.sortBy = exports.someSeries = exports.someLimit = exports.some = exports.setImmediate = exports.series = exports.seq = exports.retryable = exports.retry = exports.rejectSeries = exports.rejectLimit = exports.reject = exports.reflectAll = exports.reflect = exports.reduceRight = exports.reduce = exports.race = exports.queue = exports.priorityQueue = exports.parallelLimit = exports.parallel = exports.nextTick = exports.memoize = exports.mapValuesSeries = exports.mapValuesLimit = exports.mapValues = exports.mapSeries = exports.mapLimit = exports.map = exports.log = exports.groupBySeries = exports.groupByLimit = exports.groupBy = exports.forever = exports.filterSeries = exports.filterLimit = exports.filter = exports.everySeries = exports.everyLimit = exports.every = exports.ensureAsync = exports.eachSeries = exports.eachOfSeries = exports.eachOfLimit = exports.eachOf = exports.eachLimit = exports.each = exports.doWhilst = exports.doUntil = exports.dir = exports.detectSeries = exports.detectLimit = exports.detect = exports.constant = exports.concatSeries = exports.concatLimit = exports.concat = exports.compose = exports.cargoQueue = exports.cargo = exports.autoInject = exports.auto = exports.asyncify = exports.applyEachSeries = exports.applyEach = exports.apply = undefined;
|
||||
|
||||
var _apply = require('./apply');
|
||||
|
||||
var _apply2 = _interopRequireDefault(_apply);
|
||||
|
||||
var _applyEach = require('./applyEach');
|
||||
|
||||
var _applyEach2 = _interopRequireDefault(_applyEach);
|
||||
|
||||
var _applyEachSeries = require('./applyEachSeries');
|
||||
|
||||
var _applyEachSeries2 = _interopRequireDefault(_applyEachSeries);
|
||||
|
||||
var _asyncify = require('./asyncify');
|
||||
|
||||
var _asyncify2 = _interopRequireDefault(_asyncify);
|
||||
|
||||
var _auto = require('./auto');
|
||||
|
||||
var _auto2 = _interopRequireDefault(_auto);
|
||||
|
||||
var _autoInject = require('./autoInject');
|
||||
|
||||
var _autoInject2 = _interopRequireDefault(_autoInject);
|
||||
|
||||
var _cargo = require('./cargo');
|
||||
|
||||
var _cargo2 = _interopRequireDefault(_cargo);
|
||||
|
||||
var _cargoQueue = require('./cargoQueue');
|
||||
|
||||
var _cargoQueue2 = _interopRequireDefault(_cargoQueue);
|
||||
|
||||
var _compose = require('./compose');
|
||||
|
||||
var _compose2 = _interopRequireDefault(_compose);
|
||||
|
||||
var _concat = require('./concat');
|
||||
|
||||
var _concat2 = _interopRequireDefault(_concat);
|
||||
|
||||
var _concatLimit = require('./concatLimit');
|
||||
|
||||
var _concatLimit2 = _interopRequireDefault(_concatLimit);
|
||||
|
||||
var _concatSeries = require('./concatSeries');
|
||||
|
||||
var _concatSeries2 = _interopRequireDefault(_concatSeries);
|
||||
|
||||
var _constant = require('./constant');
|
||||
|
||||
var _constant2 = _interopRequireDefault(_constant);
|
||||
|
||||
var _detect = require('./detect');
|
||||
|
||||
var _detect2 = _interopRequireDefault(_detect);
|
||||
|
||||
var _detectLimit = require('./detectLimit');
|
||||
|
||||
var _detectLimit2 = _interopRequireDefault(_detectLimit);
|
||||
|
||||
var _detectSeries = require('./detectSeries');
|
||||
|
||||
var _detectSeries2 = _interopRequireDefault(_detectSeries);
|
||||
|
||||
var _dir = require('./dir');
|
||||
|
||||
var _dir2 = _interopRequireDefault(_dir);
|
||||
|
||||
var _doUntil = require('./doUntil');
|
||||
|
||||
var _doUntil2 = _interopRequireDefault(_doUntil);
|
||||
|
||||
var _doWhilst = require('./doWhilst');
|
||||
|
||||
var _doWhilst2 = _interopRequireDefault(_doWhilst);
|
||||
|
||||
var _each = require('./each');
|
||||
|
||||
var _each2 = _interopRequireDefault(_each);
|
||||
|
||||
var _eachLimit = require('./eachLimit');
|
||||
|
||||
var _eachLimit2 = _interopRequireDefault(_eachLimit);
|
||||
|
||||
var _eachOf = require('./eachOf');
|
||||
|
||||
var _eachOf2 = _interopRequireDefault(_eachOf);
|
||||
|
||||
var _eachOfLimit = require('./eachOfLimit');
|
||||
|
||||
var _eachOfLimit2 = _interopRequireDefault(_eachOfLimit);
|
||||
|
||||
var _eachOfSeries = require('./eachOfSeries');
|
||||
|
||||
var _eachOfSeries2 = _interopRequireDefault(_eachOfSeries);
|
||||
|
||||
var _eachSeries = require('./eachSeries');
|
||||
|
||||
var _eachSeries2 = _interopRequireDefault(_eachSeries);
|
||||
|
||||
var _ensureAsync = require('./ensureAsync');
|
||||
|
||||
var _ensureAsync2 = _interopRequireDefault(_ensureAsync);
|
||||
|
||||
var _every = require('./every');
|
||||
|
||||
var _every2 = _interopRequireDefault(_every);
|
||||
|
||||
var _everyLimit = require('./everyLimit');
|
||||
|
||||
var _everyLimit2 = _interopRequireDefault(_everyLimit);
|
||||
|
||||
var _everySeries = require('./everySeries');
|
||||
|
||||
var _everySeries2 = _interopRequireDefault(_everySeries);
|
||||
|
||||
var _filter = require('./filter');
|
||||
|
||||
var _filter2 = _interopRequireDefault(_filter);
|
||||
|
||||
var _filterLimit = require('./filterLimit');
|
||||
|
||||
var _filterLimit2 = _interopRequireDefault(_filterLimit);
|
||||
|
||||
var _filterSeries = require('./filterSeries');
|
||||
|
||||
var _filterSeries2 = _interopRequireDefault(_filterSeries);
|
||||
|
||||
var _forever = require('./forever');
|
||||
|
||||
var _forever2 = _interopRequireDefault(_forever);
|
||||
|
||||
var _groupBy = require('./groupBy');
|
||||
|
||||
var _groupBy2 = _interopRequireDefault(_groupBy);
|
||||
|
||||
var _groupByLimit = require('./groupByLimit');
|
||||
|
||||
var _groupByLimit2 = _interopRequireDefault(_groupByLimit);
|
||||
|
||||
var _groupBySeries = require('./groupBySeries');
|
||||
|
||||
var _groupBySeries2 = _interopRequireDefault(_groupBySeries);
|
||||
|
||||
var _log = require('./log');
|
||||
|
||||
var _log2 = _interopRequireDefault(_log);
|
||||
|
||||
var _map = require('./map');
|
||||
|
||||
var _map2 = _interopRequireDefault(_map);
|
||||
|
||||
var _mapLimit = require('./mapLimit');
|
||||
|
||||
var _mapLimit2 = _interopRequireDefault(_mapLimit);
|
||||
|
||||
var _mapSeries = require('./mapSeries');
|
||||
|
||||
var _mapSeries2 = _interopRequireDefault(_mapSeries);
|
||||
|
||||
var _mapValues = require('./mapValues');
|
||||
|
||||
var _mapValues2 = _interopRequireDefault(_mapValues);
|
||||
|
||||
var _mapValuesLimit = require('./mapValuesLimit');
|
||||
|
||||
var _mapValuesLimit2 = _interopRequireDefault(_mapValuesLimit);
|
||||
|
||||
var _mapValuesSeries = require('./mapValuesSeries');
|
||||
|
||||
var _mapValuesSeries2 = _interopRequireDefault(_mapValuesSeries);
|
||||
|
||||
var _memoize = require('./memoize');
|
||||
|
||||
var _memoize2 = _interopRequireDefault(_memoize);
|
||||
|
||||
var _nextTick = require('./nextTick');
|
||||
|
||||
var _nextTick2 = _interopRequireDefault(_nextTick);
|
||||
|
||||
var _parallel = require('./parallel');
|
||||
|
||||
var _parallel2 = _interopRequireDefault(_parallel);
|
||||
|
||||
var _parallelLimit = require('./parallelLimit');
|
||||
|
||||
var _parallelLimit2 = _interopRequireDefault(_parallelLimit);
|
||||
|
||||
var _priorityQueue = require('./priorityQueue');
|
||||
|
||||
var _priorityQueue2 = _interopRequireDefault(_priorityQueue);
|
||||
|
||||
var _queue = require('./queue');
|
||||
|
||||
var _queue2 = _interopRequireDefault(_queue);
|
||||
|
||||
var _race = require('./race');
|
||||
|
||||
var _race2 = _interopRequireDefault(_race);
|
||||
|
||||
var _reduce = require('./reduce');
|
||||
|
||||
var _reduce2 = _interopRequireDefault(_reduce);
|
||||
|
||||
var _reduceRight = require('./reduceRight');
|
||||
|
||||
var _reduceRight2 = _interopRequireDefault(_reduceRight);
|
||||
|
||||
var _reflect = require('./reflect');
|
||||
|
||||
var _reflect2 = _interopRequireDefault(_reflect);
|
||||
|
||||
var _reflectAll = require('./reflectAll');
|
||||
|
||||
var _reflectAll2 = _interopRequireDefault(_reflectAll);
|
||||
|
||||
var _reject = require('./reject');
|
||||
|
||||
var _reject2 = _interopRequireDefault(_reject);
|
||||
|
||||
var _rejectLimit = require('./rejectLimit');
|
||||
|
||||
var _rejectLimit2 = _interopRequireDefault(_rejectLimit);
|
||||
|
||||
var _rejectSeries = require('./rejectSeries');
|
||||
|
||||
var _rejectSeries2 = _interopRequireDefault(_rejectSeries);
|
||||
|
||||
var _retry = require('./retry');
|
||||
|
||||
var _retry2 = _interopRequireDefault(_retry);
|
||||
|
||||
var _retryable = require('./retryable');
|
||||
|
||||
var _retryable2 = _interopRequireDefault(_retryable);
|
||||
|
||||
var _seq = require('./seq');
|
||||
|
||||
var _seq2 = _interopRequireDefault(_seq);
|
||||
|
||||
var _series = require('./series');
|
||||
|
||||
var _series2 = _interopRequireDefault(_series);
|
||||
|
||||
var _setImmediate = require('./setImmediate');
|
||||
|
||||
var _setImmediate2 = _interopRequireDefault(_setImmediate);
|
||||
|
||||
var _some = require('./some');
|
||||
|
||||
var _some2 = _interopRequireDefault(_some);
|
||||
|
||||
var _someLimit = require('./someLimit');
|
||||
|
||||
var _someLimit2 = _interopRequireDefault(_someLimit);
|
||||
|
||||
var _someSeries = require('./someSeries');
|
||||
|
||||
var _someSeries2 = _interopRequireDefault(_someSeries);
|
||||
|
||||
var _sortBy = require('./sortBy');
|
||||
|
||||
var _sortBy2 = _interopRequireDefault(_sortBy);
|
||||
|
||||
var _timeout = require('./timeout');
|
||||
|
||||
var _timeout2 = _interopRequireDefault(_timeout);
|
||||
|
||||
var _times = require('./times');
|
||||
|
||||
var _times2 = _interopRequireDefault(_times);
|
||||
|
||||
var _timesLimit = require('./timesLimit');
|
||||
|
||||
var _timesLimit2 = _interopRequireDefault(_timesLimit);
|
||||
|
||||
var _timesSeries = require('./timesSeries');
|
||||
|
||||
var _timesSeries2 = _interopRequireDefault(_timesSeries);
|
||||
|
||||
var _transform = require('./transform');
|
||||
|
||||
var _transform2 = _interopRequireDefault(_transform);
|
||||
|
||||
var _tryEach = require('./tryEach');
|
||||
|
||||
var _tryEach2 = _interopRequireDefault(_tryEach);
|
||||
|
||||
var _unmemoize = require('./unmemoize');
|
||||
|
||||
var _unmemoize2 = _interopRequireDefault(_unmemoize);
|
||||
|
||||
var _until = require('./until');
|
||||
|
||||
var _until2 = _interopRequireDefault(_until);
|
||||
|
||||
var _waterfall = require('./waterfall');
|
||||
|
||||
var _waterfall2 = _interopRequireDefault(_waterfall);
|
||||
|
||||
var _whilst = require('./whilst');
|
||||
|
||||
var _whilst2 = _interopRequireDefault(_whilst);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* An "async function" in the context of Async is an asynchronous function with
|
||||
* a variable number of parameters, with the final parameter being a callback.
|
||||
* (`function (arg1, arg2, ..., callback) {}`)
|
||||
* The final callback is of the form `callback(err, results...)`, which must be
|
||||
* called once the function is completed. The callback should be called with a
|
||||
* Error as its first argument to signal that an error occurred.
|
||||
* Otherwise, if no error occurred, it should be called with `null` as the first
|
||||
* argument, and any additional `result` arguments that may apply, to signal
|
||||
* successful completion.
|
||||
* The callback must be called exactly once, ideally on a later tick of the
|
||||
* JavaScript event loop.
|
||||
*
|
||||
* This type of function is also referred to as a "Node-style async function",
|
||||
* or a "continuation passing-style function" (CPS). Most of the methods of this
|
||||
* library are themselves CPS/Node-style async functions, or functions that
|
||||
* return CPS/Node-style async functions.
|
||||
*
|
||||
* Wherever we accept a Node-style async function, we also directly accept an
|
||||
* [ES2017 `async` function]{@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function}.
|
||||
* In this case, the `async` function will not be passed a final callback
|
||||
* argument, and any thrown error will be used as the `err` argument of the
|
||||
* implicit callback, and the return value will be used as the `result` value.
|
||||
* (i.e. a `rejected` of the returned Promise becomes the `err` callback
|
||||
* argument, and a `resolved` value becomes the `result`.)
|
||||
*
|
||||
* Note, due to JavaScript limitations, we can only detect native `async`
|
||||
* functions and not transpilied implementations.
|
||||
* Your environment must have `async`/`await` support for this to work.
|
||||
* (e.g. Node > v7.6, or a recent version of a modern browser).
|
||||
* If you are using `async` functions through a transpiler (e.g. Babel), you
|
||||
* must still wrap the function with [asyncify]{@link module:Utils.asyncify},
|
||||
* because the `async function` will be compiled to an ordinary function that
|
||||
* returns a promise.
|
||||
*
|
||||
* @typedef {Function} AsyncFunction
|
||||
* @static
|
||||
*/
|
||||
|
||||
/**
|
||||
* 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) and installable via
|
||||
* `npm install --save async`, it can also be used directly in the browser.
|
||||
* @module async
|
||||
* @see AsyncFunction
|
||||
*/
|
||||
|
||||
/**
|
||||
* A collection of `async` functions for manipulating collections, such as
|
||||
* arrays and objects.
|
||||
* @module Collections
|
||||
*/
|
||||
|
||||
/**
|
||||
* A collection of `async` functions for controlling the flow through a script.
|
||||
* @module ControlFlow
|
||||
*/
|
||||
|
||||
/**
|
||||
* A collection of `async` utility functions.
|
||||
* @module Utils
|
||||
*/
|
||||
|
||||
exports.default = {
|
||||
apply: _apply2.default,
|
||||
applyEach: _applyEach2.default,
|
||||
applyEachSeries: _applyEachSeries2.default,
|
||||
asyncify: _asyncify2.default,
|
||||
auto: _auto2.default,
|
||||
autoInject: _autoInject2.default,
|
||||
cargo: _cargo2.default,
|
||||
cargoQueue: _cargoQueue2.default,
|
||||
compose: _compose2.default,
|
||||
concat: _concat2.default,
|
||||
concatLimit: _concatLimit2.default,
|
||||
concatSeries: _concatSeries2.default,
|
||||
constant: _constant2.default,
|
||||
detect: _detect2.default,
|
||||
detectLimit: _detectLimit2.default,
|
||||
detectSeries: _detectSeries2.default,
|
||||
dir: _dir2.default,
|
||||
doUntil: _doUntil2.default,
|
||||
doWhilst: _doWhilst2.default,
|
||||
each: _each2.default,
|
||||
eachLimit: _eachLimit2.default,
|
||||
eachOf: _eachOf2.default,
|
||||
eachOfLimit: _eachOfLimit2.default,
|
||||
eachOfSeries: _eachOfSeries2.default,
|
||||
eachSeries: _eachSeries2.default,
|
||||
ensureAsync: _ensureAsync2.default,
|
||||
every: _every2.default,
|
||||
everyLimit: _everyLimit2.default,
|
||||
everySeries: _everySeries2.default,
|
||||
filter: _filter2.default,
|
||||
filterLimit: _filterLimit2.default,
|
||||
filterSeries: _filterSeries2.default,
|
||||
forever: _forever2.default,
|
||||
groupBy: _groupBy2.default,
|
||||
groupByLimit: _groupByLimit2.default,
|
||||
groupBySeries: _groupBySeries2.default,
|
||||
log: _log2.default,
|
||||
map: _map2.default,
|
||||
mapLimit: _mapLimit2.default,
|
||||
mapSeries: _mapSeries2.default,
|
||||
mapValues: _mapValues2.default,
|
||||
mapValuesLimit: _mapValuesLimit2.default,
|
||||
mapValuesSeries: _mapValuesSeries2.default,
|
||||
memoize: _memoize2.default,
|
||||
nextTick: _nextTick2.default,
|
||||
parallel: _parallel2.default,
|
||||
parallelLimit: _parallelLimit2.default,
|
||||
priorityQueue: _priorityQueue2.default,
|
||||
queue: _queue2.default,
|
||||
race: _race2.default,
|
||||
reduce: _reduce2.default,
|
||||
reduceRight: _reduceRight2.default,
|
||||
reflect: _reflect2.default,
|
||||
reflectAll: _reflectAll2.default,
|
||||
reject: _reject2.default,
|
||||
rejectLimit: _rejectLimit2.default,
|
||||
rejectSeries: _rejectSeries2.default,
|
||||
retry: _retry2.default,
|
||||
retryable: _retryable2.default,
|
||||
seq: _seq2.default,
|
||||
series: _series2.default,
|
||||
setImmediate: _setImmediate2.default,
|
||||
some: _some2.default,
|
||||
someLimit: _someLimit2.default,
|
||||
someSeries: _someSeries2.default,
|
||||
sortBy: _sortBy2.default,
|
||||
timeout: _timeout2.default,
|
||||
times: _times2.default,
|
||||
timesLimit: _timesLimit2.default,
|
||||
timesSeries: _timesSeries2.default,
|
||||
transform: _transform2.default,
|
||||
tryEach: _tryEach2.default,
|
||||
unmemoize: _unmemoize2.default,
|
||||
until: _until2.default,
|
||||
waterfall: _waterfall2.default,
|
||||
whilst: _whilst2.default,
|
||||
|
||||
// aliases
|
||||
all: _every2.default,
|
||||
allLimit: _everyLimit2.default,
|
||||
allSeries: _everySeries2.default,
|
||||
any: _some2.default,
|
||||
anyLimit: _someLimit2.default,
|
||||
anySeries: _someSeries2.default,
|
||||
find: _detect2.default,
|
||||
findLimit: _detectLimit2.default,
|
||||
findSeries: _detectSeries2.default,
|
||||
flatMap: _concat2.default,
|
||||
flatMapLimit: _concatLimit2.default,
|
||||
flatMapSeries: _concatSeries2.default,
|
||||
forEach: _each2.default,
|
||||
forEachSeries: _eachSeries2.default,
|
||||
forEachLimit: _eachLimit2.default,
|
||||
forEachOf: _eachOf2.default,
|
||||
forEachOfSeries: _eachOfSeries2.default,
|
||||
forEachOfLimit: _eachOfLimit2.default,
|
||||
inject: _reduce2.default,
|
||||
foldl: _reduce2.default,
|
||||
foldr: _reduceRight2.default,
|
||||
select: _filter2.default,
|
||||
selectLimit: _filterLimit2.default,
|
||||
selectSeries: _filterSeries2.default,
|
||||
wrapSync: _asyncify2.default,
|
||||
during: _whilst2.default,
|
||||
doDuring: _doWhilst2.default
|
||||
};
|
||||
exports.apply = _apply2.default;
|
||||
exports.applyEach = _applyEach2.default;
|
||||
exports.applyEachSeries = _applyEachSeries2.default;
|
||||
exports.asyncify = _asyncify2.default;
|
||||
exports.auto = _auto2.default;
|
||||
exports.autoInject = _autoInject2.default;
|
||||
exports.cargo = _cargo2.default;
|
||||
exports.cargoQueue = _cargoQueue2.default;
|
||||
exports.compose = _compose2.default;
|
||||
exports.concat = _concat2.default;
|
||||
exports.concatLimit = _concatLimit2.default;
|
||||
exports.concatSeries = _concatSeries2.default;
|
||||
exports.constant = _constant2.default;
|
||||
exports.detect = _detect2.default;
|
||||
exports.detectLimit = _detectLimit2.default;
|
||||
exports.detectSeries = _detectSeries2.default;
|
||||
exports.dir = _dir2.default;
|
||||
exports.doUntil = _doUntil2.default;
|
||||
exports.doWhilst = _doWhilst2.default;
|
||||
exports.each = _each2.default;
|
||||
exports.eachLimit = _eachLimit2.default;
|
||||
exports.eachOf = _eachOf2.default;
|
||||
exports.eachOfLimit = _eachOfLimit2.default;
|
||||
exports.eachOfSeries = _eachOfSeries2.default;
|
||||
exports.eachSeries = _eachSeries2.default;
|
||||
exports.ensureAsync = _ensureAsync2.default;
|
||||
exports.every = _every2.default;
|
||||
exports.everyLimit = _everyLimit2.default;
|
||||
exports.everySeries = _everySeries2.default;
|
||||
exports.filter = _filter2.default;
|
||||
exports.filterLimit = _filterLimit2.default;
|
||||
exports.filterSeries = _filterSeries2.default;
|
||||
exports.forever = _forever2.default;
|
||||
exports.groupBy = _groupBy2.default;
|
||||
exports.groupByLimit = _groupByLimit2.default;
|
||||
exports.groupBySeries = _groupBySeries2.default;
|
||||
exports.log = _log2.default;
|
||||
exports.map = _map2.default;
|
||||
exports.mapLimit = _mapLimit2.default;
|
||||
exports.mapSeries = _mapSeries2.default;
|
||||
exports.mapValues = _mapValues2.default;
|
||||
exports.mapValuesLimit = _mapValuesLimit2.default;
|
||||
exports.mapValuesSeries = _mapValuesSeries2.default;
|
||||
exports.memoize = _memoize2.default;
|
||||
exports.nextTick = _nextTick2.default;
|
||||
exports.parallel = _parallel2.default;
|
||||
exports.parallelLimit = _parallelLimit2.default;
|
||||
exports.priorityQueue = _priorityQueue2.default;
|
||||
exports.queue = _queue2.default;
|
||||
exports.race = _race2.default;
|
||||
exports.reduce = _reduce2.default;
|
||||
exports.reduceRight = _reduceRight2.default;
|
||||
exports.reflect = _reflect2.default;
|
||||
exports.reflectAll = _reflectAll2.default;
|
||||
exports.reject = _reject2.default;
|
||||
exports.rejectLimit = _rejectLimit2.default;
|
||||
exports.rejectSeries = _rejectSeries2.default;
|
||||
exports.retry = _retry2.default;
|
||||
exports.retryable = _retryable2.default;
|
||||
exports.seq = _seq2.default;
|
||||
exports.series = _series2.default;
|
||||
exports.setImmediate = _setImmediate2.default;
|
||||
exports.some = _some2.default;
|
||||
exports.someLimit = _someLimit2.default;
|
||||
exports.someSeries = _someSeries2.default;
|
||||
exports.sortBy = _sortBy2.default;
|
||||
exports.timeout = _timeout2.default;
|
||||
exports.times = _times2.default;
|
||||
exports.timesLimit = _timesLimit2.default;
|
||||
exports.timesSeries = _timesSeries2.default;
|
||||
exports.transform = _transform2.default;
|
||||
exports.tryEach = _tryEach2.default;
|
||||
exports.unmemoize = _unmemoize2.default;
|
||||
exports.until = _until2.default;
|
||||
exports.waterfall = _waterfall2.default;
|
||||
exports.whilst = _whilst2.default;
|
||||
exports.all = _every2.default;
|
||||
exports.allLimit = _everyLimit2.default;
|
||||
exports.allSeries = _everySeries2.default;
|
||||
exports.any = _some2.default;
|
||||
exports.anyLimit = _someLimit2.default;
|
||||
exports.anySeries = _someSeries2.default;
|
||||
exports.find = _detect2.default;
|
||||
exports.findLimit = _detectLimit2.default;
|
||||
exports.findSeries = _detectSeries2.default;
|
||||
exports.flatMap = _concat2.default;
|
||||
exports.flatMapLimit = _concatLimit2.default;
|
||||
exports.flatMapSeries = _concatSeries2.default;
|
||||
exports.forEach = _each2.default;
|
||||
exports.forEachSeries = _eachSeries2.default;
|
||||
exports.forEachLimit = _eachLimit2.default;
|
||||
exports.forEachOf = _eachOf2.default;
|
||||
exports.forEachOfSeries = _eachOfSeries2.default;
|
||||
exports.forEachOfLimit = _eachOfLimit2.default;
|
||||
exports.inject = _reduce2.default;
|
||||
exports.foldl = _reduce2.default;
|
||||
exports.foldr = _reduceRight2.default;
|
||||
exports.select = _filter2.default;
|
||||
exports.selectLimit = _filterLimit2.default;
|
||||
exports.selectSeries = _filterSeries2.default;
|
||||
exports.wrapSync = _asyncify2.default;
|
||||
exports.during = _whilst2.default;
|
||||
exports.doDuring = _doWhilst2.default;
|
||||
|
|
@ -1,153 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _eachOfSeries = require('./eachOfSeries.js');
|
||||
|
||||
var _eachOfSeries2 = _interopRequireDefault(_eachOfSeries);
|
||||
|
||||
var _once = require('./internal/once.js');
|
||||
|
||||
var _once2 = _interopRequireDefault(_once);
|
||||
|
||||
var _wrapAsync = require('./internal/wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./internal/awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
/**
|
||||
* Reduces `coll` into a single value using an async `iteratee` to return each
|
||||
* successive step. `memo` is the initial state of the reduction. This function
|
||||
* only operates in series.
|
||||
*
|
||||
* For performance reasons, it may make sense to split a call to this function
|
||||
* into a parallel map, and then use the normal `Array.prototype.reduce` on the
|
||||
* results. This function is for situations where each step in the reduction
|
||||
* needs to be async; if you can get the data before reducing it, then it's
|
||||
* probably a good idea to do so.
|
||||
*
|
||||
* @name reduce
|
||||
* @static
|
||||
* @memberOf module:Collections
|
||||
* @method
|
||||
* @alias inject
|
||||
* @alias foldl
|
||||
* @category Collection
|
||||
* @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
|
||||
* @param {*} memo - The initial state of the reduction.
|
||||
* @param {AsyncFunction} iteratee - A function applied to each item in the
|
||||
* array to produce the next step in the reduction.
|
||||
* The `iteratee` should complete with the next state of the reduction.
|
||||
* If the iteratee completes with an error, the reduction is stopped and the
|
||||
* main `callback` is immediately called with the error.
|
||||
* Invoked with (memo, item, callback).
|
||||
* @param {Function} [callback] - A callback which is called after all the
|
||||
* `iteratee` functions have finished. Result is the reduced value. Invoked with
|
||||
* (err, result).
|
||||
* @returns {Promise} a promise, if no callback is passed
|
||||
* @example
|
||||
*
|
||||
* // file1.txt is a file that is 1000 bytes in size
|
||||
* // file2.txt is a file that is 2000 bytes in size
|
||||
* // file3.txt is a file that is 3000 bytes in size
|
||||
* // file4.txt does not exist
|
||||
*
|
||||
* const fileList = ['file1.txt','file2.txt','file3.txt'];
|
||||
* const withMissingFileList = ['file1.txt','file2.txt','file3.txt', 'file4.txt'];
|
||||
*
|
||||
* // asynchronous function that computes the file size in bytes
|
||||
* // file size is added to the memoized value, then returned
|
||||
* function getFileSizeInBytes(memo, file, callback) {
|
||||
* fs.stat(file, function(err, stat) {
|
||||
* if (err) {
|
||||
* return callback(err);
|
||||
* }
|
||||
* callback(null, memo + stat.size);
|
||||
* });
|
||||
* }
|
||||
*
|
||||
* // Using callbacks
|
||||
* async.reduce(fileList, 0, getFileSizeInBytes, function(err, result) {
|
||||
* if (err) {
|
||||
* console.log(err);
|
||||
* } else {
|
||||
* console.log(result);
|
||||
* // 6000
|
||||
* // which is the sum of the file sizes of the three files
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.reduce(withMissingFileList, 0, getFileSizeInBytes, function(err, result) {
|
||||
* if (err) {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* } else {
|
||||
* console.log(result);
|
||||
* }
|
||||
* });
|
||||
*
|
||||
* // Using Promises
|
||||
* async.reduce(fileList, 0, getFileSizeInBytes)
|
||||
* .then( result => {
|
||||
* console.log(result);
|
||||
* // 6000
|
||||
* // which is the sum of the file sizes of the three files
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* });
|
||||
*
|
||||
* // Error Handling
|
||||
* async.reduce(withMissingFileList, 0, getFileSizeInBytes)
|
||||
* .then( result => {
|
||||
* console.log(result);
|
||||
* }).catch( err => {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* });
|
||||
*
|
||||
* // Using async/await
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.reduce(fileList, 0, getFileSizeInBytes);
|
||||
* console.log(result);
|
||||
* // 6000
|
||||
* // which is the sum of the file sizes of the three files
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* // Error Handling
|
||||
* async () => {
|
||||
* try {
|
||||
* let result = await async.reduce(withMissingFileList, 0, getFileSizeInBytes);
|
||||
* console.log(result);
|
||||
* }
|
||||
* catch (err) {
|
||||
* console.log(err);
|
||||
* // [ Error: ENOENT: no such file or directory ]
|
||||
* }
|
||||
* }
|
||||
*
|
||||
*/
|
||||
function reduce(coll, memo, iteratee, callback) {
|
||||
callback = (0, _once2.default)(callback);
|
||||
var _iteratee = (0, _wrapAsync2.default)(iteratee);
|
||||
return (0, _eachOfSeries2.default)(coll, (x, i, iterCb) => {
|
||||
_iteratee(memo, x, (err, v) => {
|
||||
memo = v;
|
||||
iterCb(err);
|
||||
});
|
||||
}, err => callback(err, memo));
|
||||
}
|
||||
exports.default = (0, _awaitify2.default)(reduce, 4);
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,92 +0,0 @@
|
|||
"use strict";
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
// Simple doubly linked list (https://en.wikipedia.org/wiki/Doubly_linked_list) implementation
|
||||
// used for queues. This implementation assumes that the node provided by the user can be modified
|
||||
// to adjust the next and last properties. We implement only the minimal functionality
|
||||
// for queue support.
|
||||
class DLL {
|
||||
constructor() {
|
||||
this.head = this.tail = null;
|
||||
this.length = 0;
|
||||
}
|
||||
|
||||
removeLink(node) {
|
||||
if (node.prev) node.prev.next = node.next;else this.head = node.next;
|
||||
if (node.next) node.next.prev = node.prev;else this.tail = node.prev;
|
||||
|
||||
node.prev = node.next = null;
|
||||
this.length -= 1;
|
||||
return node;
|
||||
}
|
||||
|
||||
empty() {
|
||||
while (this.head) this.shift();
|
||||
return this;
|
||||
}
|
||||
|
||||
insertAfter(node, newNode) {
|
||||
newNode.prev = node;
|
||||
newNode.next = node.next;
|
||||
if (node.next) node.next.prev = newNode;else this.tail = newNode;
|
||||
node.next = newNode;
|
||||
this.length += 1;
|
||||
}
|
||||
|
||||
insertBefore(node, newNode) {
|
||||
newNode.prev = node.prev;
|
||||
newNode.next = node;
|
||||
if (node.prev) node.prev.next = newNode;else this.head = newNode;
|
||||
node.prev = newNode;
|
||||
this.length += 1;
|
||||
}
|
||||
|
||||
unshift(node) {
|
||||
if (this.head) this.insertBefore(this.head, node);else setInitial(this, node);
|
||||
}
|
||||
|
||||
push(node) {
|
||||
if (this.tail) this.insertAfter(this.tail, node);else setInitial(this, node);
|
||||
}
|
||||
|
||||
shift() {
|
||||
return this.head && this.removeLink(this.head);
|
||||
}
|
||||
|
||||
pop() {
|
||||
return this.tail && this.removeLink(this.tail);
|
||||
}
|
||||
|
||||
toArray() {
|
||||
return [...this];
|
||||
}
|
||||
|
||||
*[Symbol.iterator]() {
|
||||
var cur = this.head;
|
||||
while (cur) {
|
||||
yield cur.data;
|
||||
cur = cur.next;
|
||||
}
|
||||
}
|
||||
|
||||
remove(testFn) {
|
||||
var curr = this.head;
|
||||
while (curr) {
|
||||
var { next } = curr;
|
||||
if (testFn(curr)) {
|
||||
this.removeLink(curr);
|
||||
}
|
||||
curr = next;
|
||||
}
|
||||
return this;
|
||||
}
|
||||
}
|
||||
|
||||
exports.default = DLL;
|
||||
function setInitial(dll, node) {
|
||||
dll.length = 1;
|
||||
dll.head = dll.tail = node;
|
||||
}
|
||||
module.exports = exports["default"];
|
||||
|
|
@ -1,120 +0,0 @@
|
|||
"use strict";
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
// Binary min-heap implementation used for priority queue.
|
||||
// Implementation is stable, i.e. push time is considered for equal priorities
|
||||
class Heap {
|
||||
constructor() {
|
||||
this.heap = [];
|
||||
this.pushCount = Number.MIN_SAFE_INTEGER;
|
||||
}
|
||||
|
||||
get length() {
|
||||
return this.heap.length;
|
||||
}
|
||||
|
||||
empty() {
|
||||
this.heap = [];
|
||||
return this;
|
||||
}
|
||||
|
||||
percUp(index) {
|
||||
let p;
|
||||
|
||||
while (index > 0 && smaller(this.heap[index], this.heap[p = parent(index)])) {
|
||||
let t = this.heap[index];
|
||||
this.heap[index] = this.heap[p];
|
||||
this.heap[p] = t;
|
||||
|
||||
index = p;
|
||||
}
|
||||
}
|
||||
|
||||
percDown(index) {
|
||||
let l;
|
||||
|
||||
while ((l = leftChi(index)) < this.heap.length) {
|
||||
if (l + 1 < this.heap.length && smaller(this.heap[l + 1], this.heap[l])) {
|
||||
l = l + 1;
|
||||
}
|
||||
|
||||
if (smaller(this.heap[index], this.heap[l])) {
|
||||
break;
|
||||
}
|
||||
|
||||
let t = this.heap[index];
|
||||
this.heap[index] = this.heap[l];
|
||||
this.heap[l] = t;
|
||||
|
||||
index = l;
|
||||
}
|
||||
}
|
||||
|
||||
push(node) {
|
||||
node.pushCount = ++this.pushCount;
|
||||
this.heap.push(node);
|
||||
this.percUp(this.heap.length - 1);
|
||||
}
|
||||
|
||||
unshift(node) {
|
||||
return this.heap.push(node);
|
||||
}
|
||||
|
||||
shift() {
|
||||
let [top] = this.heap;
|
||||
|
||||
this.heap[0] = this.heap[this.heap.length - 1];
|
||||
this.heap.pop();
|
||||
this.percDown(0);
|
||||
|
||||
return top;
|
||||
}
|
||||
|
||||
toArray() {
|
||||
return [...this];
|
||||
}
|
||||
|
||||
*[Symbol.iterator]() {
|
||||
for (let i = 0; i < this.heap.length; i++) {
|
||||
yield this.heap[i].data;
|
||||
}
|
||||
}
|
||||
|
||||
remove(testFn) {
|
||||
let j = 0;
|
||||
for (let i = 0; i < this.heap.length; i++) {
|
||||
if (!testFn(this.heap[i])) {
|
||||
this.heap[j] = this.heap[i];
|
||||
j++;
|
||||
}
|
||||
}
|
||||
|
||||
this.heap.splice(j);
|
||||
|
||||
for (let i = parent(this.heap.length - 1); i >= 0; i--) {
|
||||
this.percDown(i);
|
||||
}
|
||||
|
||||
return this;
|
||||
}
|
||||
}
|
||||
|
||||
exports.default = Heap;
|
||||
function leftChi(i) {
|
||||
return (i << 1) + 1;
|
||||
}
|
||||
|
||||
function parent(i) {
|
||||
return (i + 1 >> 1) - 1;
|
||||
}
|
||||
|
||||
function smaller(x, y) {
|
||||
if (x.priority !== y.priority) {
|
||||
return x.priority < y.priority;
|
||||
} else {
|
||||
return x.pushCount < y.pushCount;
|
||||
}
|
||||
}
|
||||
module.exports = exports["default"];
|
||||
|
|
@ -1,29 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
exports.default = function (eachfn) {
|
||||
return function applyEach(fns, ...callArgs) {
|
||||
const go = (0, _awaitify2.default)(function (callback) {
|
||||
var that = this;
|
||||
return eachfn(fns, (fn, cb) => {
|
||||
(0, _wrapAsync2.default)(fn).apply(that, callArgs.concat(cb));
|
||||
}, callback);
|
||||
});
|
||||
return go;
|
||||
};
|
||||
};
|
||||
|
||||
var _wrapAsync = require('./wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
var _awaitify = require('./awaitify.js');
|
||||
|
||||
var _awaitify2 = _interopRequireDefault(_awaitify);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,75 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = asyncEachOfLimit;
|
||||
|
||||
var _breakLoop = require('./breakLoop.js');
|
||||
|
||||
var _breakLoop2 = _interopRequireDefault(_breakLoop);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
// for async generators
|
||||
function asyncEachOfLimit(generator, limit, iteratee, callback) {
|
||||
let done = false;
|
||||
let canceled = false;
|
||||
let awaiting = false;
|
||||
let running = 0;
|
||||
let idx = 0;
|
||||
|
||||
function replenish() {
|
||||
//console.log('replenish')
|
||||
if (running >= limit || awaiting || done) return;
|
||||
//console.log('replenish awaiting')
|
||||
awaiting = true;
|
||||
generator.next().then(({ value, done: iterDone }) => {
|
||||
//console.log('got value', value)
|
||||
if (canceled || done) return;
|
||||
awaiting = false;
|
||||
if (iterDone) {
|
||||
done = true;
|
||||
if (running <= 0) {
|
||||
//console.log('done nextCb')
|
||||
callback(null);
|
||||
}
|
||||
return;
|
||||
}
|
||||
running++;
|
||||
iteratee(value, idx, iterateeCallback);
|
||||
idx++;
|
||||
replenish();
|
||||
}).catch(handleError);
|
||||
}
|
||||
|
||||
function iterateeCallback(err, result) {
|
||||
//console.log('iterateeCallback')
|
||||
running -= 1;
|
||||
if (canceled) return;
|
||||
if (err) return handleError(err);
|
||||
|
||||
if (err === false) {
|
||||
done = true;
|
||||
canceled = true;
|
||||
return;
|
||||
}
|
||||
|
||||
if (result === _breakLoop2.default || done && running <= 0) {
|
||||
done = true;
|
||||
//console.log('done iterCb')
|
||||
return callback(null);
|
||||
}
|
||||
replenish();
|
||||
}
|
||||
|
||||
function handleError(err) {
|
||||
if (canceled) return;
|
||||
awaiting = false;
|
||||
done = true;
|
||||
callback(err);
|
||||
}
|
||||
|
||||
replenish();
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,27 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = awaitify;
|
||||
// conditionally promisify a function.
|
||||
// only return a promise if a callback is omitted
|
||||
function awaitify(asyncFn, arity = asyncFn.length) {
|
||||
if (!arity) throw new Error('arity is undefined');
|
||||
function awaitable(...args) {
|
||||
if (typeof args[arity - 1] === 'function') {
|
||||
return asyncFn.apply(this, args);
|
||||
}
|
||||
|
||||
return new Promise((resolve, reject) => {
|
||||
args[arity - 1] = (err, ...cbArgs) => {
|
||||
if (err) return reject(err);
|
||||
resolve(cbArgs.length > 1 ? cbArgs : cbArgs[0]);
|
||||
};
|
||||
asyncFn.apply(this, args);
|
||||
});
|
||||
}
|
||||
|
||||
return awaitable;
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,10 +0,0 @@
|
|||
"use strict";
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
// A temporary value used to identify if the loop should be broken.
|
||||
// See #1064, #1293
|
||||
const breakLoop = {};
|
||||
exports.default = breakLoop;
|
||||
module.exports = exports["default"];
|
||||
|
|
@ -1,31 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = consoleFunc;
|
||||
|
||||
var _wrapAsync = require('./wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
function consoleFunc(name) {
|
||||
return (fn, ...args) => (0, _wrapAsync2.default)(fn)(...args, (err, ...resultArgs) => {
|
||||
/* istanbul ignore else */
|
||||
if (typeof console === 'object') {
|
||||
/* istanbul ignore else */
|
||||
if (err) {
|
||||
/* istanbul ignore else */
|
||||
if (console.error) {
|
||||
console.error(err);
|
||||
}
|
||||
} else if (console[name]) {
|
||||
/* istanbul ignore else */
|
||||
resultArgs.forEach(x => console[name](x));
|
||||
}
|
||||
}
|
||||
});
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,40 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = _createTester;
|
||||
|
||||
var _breakLoop = require('./breakLoop.js');
|
||||
|
||||
var _breakLoop2 = _interopRequireDefault(_breakLoop);
|
||||
|
||||
var _wrapAsync = require('./wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
function _createTester(check, getResult) {
|
||||
return (eachfn, arr, _iteratee, cb) => {
|
||||
var testPassed = false;
|
||||
var testResult;
|
||||
const iteratee = (0, _wrapAsync2.default)(_iteratee);
|
||||
eachfn(arr, (value, _, callback) => {
|
||||
iteratee(value, (err, result) => {
|
||||
if (err || err === false) return callback(err);
|
||||
|
||||
if (check(result) && !testResult) {
|
||||
testPassed = true;
|
||||
testResult = getResult(true, value);
|
||||
return callback(null, _breakLoop2.default);
|
||||
}
|
||||
callback();
|
||||
});
|
||||
}, err => {
|
||||
if (err) return cb(err);
|
||||
cb(null, testPassed ? testResult : getResult(false));
|
||||
});
|
||||
};
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,90 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
var _once = require('./once.js');
|
||||
|
||||
var _once2 = _interopRequireDefault(_once);
|
||||
|
||||
var _iterator = require('./iterator.js');
|
||||
|
||||
var _iterator2 = _interopRequireDefault(_iterator);
|
||||
|
||||
var _onlyOnce = require('./onlyOnce.js');
|
||||
|
||||
var _onlyOnce2 = _interopRequireDefault(_onlyOnce);
|
||||
|
||||
var _wrapAsync = require('./wrapAsync.js');
|
||||
|
||||
var _asyncEachOfLimit = require('./asyncEachOfLimit.js');
|
||||
|
||||
var _asyncEachOfLimit2 = _interopRequireDefault(_asyncEachOfLimit);
|
||||
|
||||
var _breakLoop = require('./breakLoop.js');
|
||||
|
||||
var _breakLoop2 = _interopRequireDefault(_breakLoop);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
exports.default = limit => {
|
||||
return (obj, iteratee, callback) => {
|
||||
callback = (0, _once2.default)(callback);
|
||||
if (limit <= 0) {
|
||||
throw new RangeError('concurrency limit cannot be less than 1');
|
||||
}
|
||||
if (!obj) {
|
||||
return callback(null);
|
||||
}
|
||||
if ((0, _wrapAsync.isAsyncGenerator)(obj)) {
|
||||
return (0, _asyncEachOfLimit2.default)(obj, limit, iteratee, callback);
|
||||
}
|
||||
if ((0, _wrapAsync.isAsyncIterable)(obj)) {
|
||||
return (0, _asyncEachOfLimit2.default)(obj[Symbol.asyncIterator](), limit, iteratee, callback);
|
||||
}
|
||||
var nextElem = (0, _iterator2.default)(obj);
|
||||
var done = false;
|
||||
var canceled = false;
|
||||
var running = 0;
|
||||
var looping = false;
|
||||
|
||||
function iterateeCallback(err, value) {
|
||||
if (canceled) return;
|
||||
running -= 1;
|
||||
if (err) {
|
||||
done = true;
|
||||
callback(err);
|
||||
} else if (err === false) {
|
||||
done = true;
|
||||
canceled = true;
|
||||
} else if (value === _breakLoop2.default || done && running <= 0) {
|
||||
done = true;
|
||||
return callback(null);
|
||||
} else if (!looping) {
|
||||
replenish();
|
||||
}
|
||||
}
|
||||
|
||||
function replenish() {
|
||||
looping = true;
|
||||
while (running < limit && !done) {
|
||||
var elem = nextElem();
|
||||
if (elem === null) {
|
||||
done = true;
|
||||
if (running <= 0) {
|
||||
callback(null);
|
||||
}
|
||||
return;
|
||||
}
|
||||
running += 1;
|
||||
iteratee(elem.value, elem.key, (0, _onlyOnce2.default)(iterateeCallback));
|
||||
}
|
||||
looping = false;
|
||||
}
|
||||
|
||||
replenish();
|
||||
};
|
||||
};
|
||||
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,55 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = _filter;
|
||||
|
||||
var _isArrayLike = require('./isArrayLike.js');
|
||||
|
||||
var _isArrayLike2 = _interopRequireDefault(_isArrayLike);
|
||||
|
||||
var _wrapAsync = require('./wrapAsync.js');
|
||||
|
||||
var _wrapAsync2 = _interopRequireDefault(_wrapAsync);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
function filterArray(eachfn, arr, iteratee, callback) {
|
||||
var truthValues = new Array(arr.length);
|
||||
eachfn(arr, (x, index, iterCb) => {
|
||||
iteratee(x, (err, v) => {
|
||||
truthValues[index] = !!v;
|
||||
iterCb(err);
|
||||
});
|
||||
}, err => {
|
||||
if (err) return callback(err);
|
||||
var results = [];
|
||||
for (var i = 0; i < arr.length; i++) {
|
||||
if (truthValues[i]) results.push(arr[i]);
|
||||
}
|
||||
callback(null, results);
|
||||
});
|
||||
}
|
||||
|
||||
function filterGeneric(eachfn, coll, iteratee, callback) {
|
||||
var results = [];
|
||||
eachfn(coll, (x, index, iterCb) => {
|
||||
iteratee(x, (err, v) => {
|
||||
if (err) return iterCb(err);
|
||||
if (v) {
|
||||
results.push({ index, value: x });
|
||||
}
|
||||
iterCb(err);
|
||||
});
|
||||
}, err => {
|
||||
if (err) return callback(err);
|
||||
callback(null, results.sort((a, b) => a.index - b.index).map(v => v.value));
|
||||
});
|
||||
}
|
||||
|
||||
function _filter(eachfn, coll, iteratee, callback) {
|
||||
var filter = (0, _isArrayLike2.default)(coll) ? filterArray : filterGeneric;
|
||||
return filter(eachfn, coll, (0, _wrapAsync2.default)(iteratee), callback);
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
"use strict";
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
exports.default = function (coll) {
|
||||
return coll[Symbol.iterator] && coll[Symbol.iterator]();
|
||||
};
|
||||
|
||||
module.exports = exports["default"];
|
||||
|
|
@ -1,14 +0,0 @@
|
|||
"use strict";
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
|
||||
exports.default = function (fn) {
|
||||
return function (...args /*, callback*/) {
|
||||
var callback = args.pop();
|
||||
return fn.call(this, args, callback);
|
||||
};
|
||||
};
|
||||
|
||||
module.exports = exports["default"];
|
||||
|
|
@ -1,10 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = isArrayLike;
|
||||
function isArrayLike(value) {
|
||||
return value && typeof value.length === 'number' && value.length >= 0 && value.length % 1 === 0;
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
|
|
@ -1,57 +0,0 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, "__esModule", {
|
||||
value: true
|
||||
});
|
||||
exports.default = createIterator;
|
||||
|
||||
var _isArrayLike = require('./isArrayLike.js');
|
||||
|
||||
var _isArrayLike2 = _interopRequireDefault(_isArrayLike);
|
||||
|
||||
var _getIterator = require('./getIterator.js');
|
||||
|
||||
var _getIterator2 = _interopRequireDefault(_getIterator);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
function createArrayIterator(coll) {
|
||||
var i = -1;
|
||||
var len = coll.length;
|
||||
return function next() {
|
||||
return ++i < len ? { value: coll[i], key: i } : null;
|
||||
};
|
||||
}
|
||||
|
||||
function createES2015Iterator(iterator) {
|
||||
var i = -1;
|
||||
return function next() {
|
||||
var item = iterator.next();
|
||||
if (item.done) return null;
|
||||
i++;
|
||||
return { value: item.value, key: i };
|
||||
};
|
||||
}
|
||||
|
||||
function createObjectIterator(obj) {
|
||||
var okeys = obj ? Object.keys(obj) : [];
|
||||
var i = -1;
|
||||
var len = okeys.length;
|
||||
return function next() {
|
||||
var key = okeys[++i];
|
||||
if (key === '__proto__') {
|
||||
return next();
|
||||
}
|
||||
return i < len ? { value: obj[key], key } : null;
|
||||
};
|
||||
}
|
||||
|
||||
function createIterator(coll) {
|
||||
if ((0, _isArrayLike2.default)(coll)) {
|
||||
return createArrayIterator(coll);
|
||||
}
|
||||
|
||||
var iterator = (0, _getIterator2.default)(coll);
|
||||
return iterator ? createES2015Iterator(iterator) : createObjectIterator(coll);
|
||||
}
|
||||
module.exports = exports['default'];
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue