'use strict'; const { Each } = require('./each'); const { setShorthand } = require('./internal/collection'); class Find extends Each { constructor(collection, iterator) { super(collection, iterator, set); } } module.exports = { find, Find }; function set(collection) { setShorthand.call(this, collection); this._callResolve = this._keys === undefined ? callResolveArray : callResolveObject; return this; } function callResolveArray(value, index) { if (value) { this._size = 0; this._promise._resolve(this._coll[index]); } else if (--this._rest === 0) { this._promise._resolve(); } } function callResolveObject(value, index) { if (value) { this._size = 0; this._promise._resolve(this._coll[this._keys[index]]); } else if (--this._rest === 0) { this._promise._resolve(); } } /** * `Aigle.find` has almost the same functionality as `Array#find`. * It iterates all elements of `collection` and executes `iterator` using each element on parallel. * The `iterator` needs to return a promise or something. * If a promise is returned, the function will wait until the promise is fulfilled. * If the result is truthly, the element will be returned as a result. * @param {Array|Object} collection * @param {Function|Array|Object|string} iterator * @return {Aigle} Returns an Aigle instance * @example * const order = []; * const collection = [1, 4, 2]; * const iterator = num => { * return Aigle.delay(num * 10) * .then(() => { * order.push(num); * return num % 2 === 0; * }); * }; * Aigle.find(collection, iterator) * .then(value => { * console.log(value); // 2 * console.log(order); // [1, 2] * }); * * @example * const order = []; * const collection = { a: 1, b: 4, c: 2 }; * const iterator = num => { * return Aigle.delay(num * 10) * .then(() => { * order.push(num); * return num % 2 === 0; * }); * }; * Aigle.find(collection, iterator) * .then(value => { * console.log(value); // 2 * console.log(order); // [1, 2] * }); * * @example * const order = []; * const collection = [1, 4, 2]; * const iterator = num => { * return Aigle.delay(num * 10) * .then(() => { * order.push(num); * return false; * }); * }; * Aigle.find(collection, iterator) * .then(value => { * console.log(value); // undefined * console.log(order); // [1, 2, 4] * }); * * @example * const collection = [{ * name: 'bargey', active: false * }, { * name: 'fread', active: true * }]; * Aigle.find(collection, 'active') * .then(object => { * console.log(object); // { name: 'fread', active: true } * }); * * @example * const collection = [{ * name: 'bargey', active: false * }, { * name: 'fread', active: true * }]; * Aigle.find(collection, ['name', 'fread']) * .then(object => { * console.log(object); // { name: 'fread', active: true } * }); * * @example * const collection = [{ * name: 'bargey', active: false * }, { * name: 'fread', active: true * }]; * Aigle.find(collection, { name: 'fread', active: true }) * .then(object => { * console.log(object); // { name: 'fread', active: true } * }); */ function find(collection, iterator) { return new Find(collection, iterator)._execute(); }