UNPKG

1.9 kBJavaScriptView Raw
1'use strict';
2
3Object.defineProperty(exports, "__esModule", {
4 value: true
5});
6
7var _createTester = require('./internal/createTester');
8
9var _createTester2 = _interopRequireDefault(_createTester);
10
11var _eachOf = require('./eachOf');
12
13var _eachOf2 = _interopRequireDefault(_eachOf);
14
15var _awaitify = require('./internal/awaitify');
16
17var _awaitify2 = _interopRequireDefault(_awaitify);
18
19function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
20
21/**
22 * Returns `true` if at least one element in the `coll` satisfies an async test.
23 * If any iteratee call returns `true`, the main `callback` is immediately
24 * called.
25 *
26 * @name some
27 * @static
28 * @memberOf module:Collections
29 * @method
30 * @alias any
31 * @category Collection
32 * @param {Array|Iterable|AsyncIterable|Object} coll - A collection to iterate over.
33 * @param {AsyncFunction} iteratee - An async truth test to apply to each item
34 * in the collections in parallel.
35 * The iteratee should complete with a boolean `result` value.
36 * Invoked with (item, callback).
37 * @param {Function} [callback] - A callback which is called as soon as any
38 * iteratee returns `true`, or after all the iteratee functions have finished.
39 * Result will be either `true` or `false` depending on the values of the async
40 * tests. Invoked with (err, result).
41 * @returns {Promise} a promise, if no callback provided
42 * @example
43 *
44 * async.some(['file1','file2','file3'], function(filePath, callback) {
45 * fs.access(filePath, function(err) {
46 * callback(null, !err)
47 * });
48 * }, function(err, result) {
49 * // if result is true then at least one of the files exists
50 * });
51 */
52function some(coll, iteratee, callback) {
53 return (0, _createTester2.default)(Boolean, res => res)(_eachOf2.default, coll, iteratee, callback);
54}
55exports.default = (0, _awaitify2.default)(some, 3);
56module.exports = exports['default'];
\No newline at end of file