_.map

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_.map_.mapValues_.reject, and _.some.

The guarded methods are:
arychunkcurrycurryRightdropdropRighteveryfillinvertparseIntrandomrangerangeRightrepeatsampleSizeslicesomesortBysplittaketakeRighttemplatetrimtrimEndtrimStart, and words

Since

0.1.0

Arguments

  1. collection (Array|Object): The collection to iterate over.
  2. [iteratee=_.identity] (Function): The function invoked per iteration.

Returns

(Array): Returns the new mapped array.

Example

function square(n) {
  return n * n;
}
 
_.map([4, 8], square);
// => [16, 64]
 
_.map({ 'a': 4, 'b': 8 }, square);
// => [16, 64] (iteration order is not guaranteed)
 
var users = [
  { 'user': 'barney' },
  { 'user': 'fred' }
];
 
// The `_.property` iteratee shorthand.
_.map(users, 'user');
// => ['barney', 'fred']