'use strict'; const { Each } = require('./each'); const { setShorthand } = require('./internal/collection'); class Map extends Each { constructor(collection, iterator) { super(collection, iterator, set); } _callResolve(value, index) { this._result[index] = value; if (--this._rest === 0) { this._promise._resolve(this._result); } } } module.exports = { map, Map }; function set(collection) { setShorthand.call(this, collection); this._result = Array(this._rest); return this; } /** * `Aigle.map` has almost the same functionality as `Array#map`. * It iterates all elements of `collection` and executes `iterator` using each element on parallel. * The `iterator` needs to return a promise or something. * Then the result will be assigned to an array and the array order will be ensured. * All of them are finished, the function will return an array as a result. * @param {Array|Object} collection * @param {Function|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; * }); * }; * Aigle.map(collection, iterator) * .then(array => { * console.log(array); // [2, 8, 4]; * console.log(order); // [1, 2, 4]; * }); * * @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; * }); * }; * Aigle.map(collection, iterator) * .then(array => { * console.log(array); // [2, 8, 4]; * console.log(order); // [1, 2, 4]; * }); * * @example * const collection = [{ * uid: 1, name: 'test1' * }, { * uid: 4, name: 'test4' * }, { * uid: 2, name: 'test2' * }]; * Aigle.map(collection, 'uid') * .then(uids => console.log(uids)); // [1, 4, 2] */ function map(collection, iterator) { return new Map(collection, iterator)._execute(); }