since 0.1.0


  • Array|Object The collection to iterate over.
  • Function The function invoked per iteration.


Array the new mapped array.

Creates an array of values by running each element in collection thru iteratee. The iteratee is invoked with three arguments: (value, index|key, collection).

Many lodash methods are guarded to work as iteratees for methods like _.every, _.filter,, _.mapValues, _.reject, and _.some.

The guarded methods are: ary, chunk, curry, curryRight, drop, dropRight, every, fill, invert, parseInt, random, range, rangeRight, repeat, sampleSize, slice, some, sortBy, split, take, takeRight, template, trim, trimEnd, trimStart, and words

Example of Lodash

function square(n) {
  return n * n;
}[4, 8], square);
// => [16, 64]{ 'a': 4, 'b': 8 }, square);
// => [16, 64] (iteration order is not guaranteed)

var users = [
  { 'user': 'barney' },
  { 'user': 'fred' }

// The `` iteratee shorthand., 'user');
// => ['barney', 'fred']