map source npm
_.map(collection, [iteratee=_.identity])
创建一个经过 iteratee 处理的集合中每一个元素的结果数组。
iteratee 会传入3个参数:(value, index|key, collection)。
有许多 lodash 的方法以 iteratees 的身份守护其工作,例如:
_.every, _.filter, _.map, _.mapValues, _.reject, 以及 _.some
被守护的有:
ary, curry, curryRight, drop, dropRight, every, fill,
invert, parseInt, random, range, rangeRight, slice, some,
sortBy, take, takeRight, template, trim, trimEnd, trimStart,
以及 words
参数
- collection (Array|Object)
需要遍历的集合
- [iteratee=_.identity] (Function|Object|string)
这个函数会处理每一个元素
返回值 (Array)
返回映射后的新数组
示例
function square(n) {
return n * n;
}
_.map([4, 8], square);
// => [16, 64]
_.map({ 'a': 4, 'b': 8 }, square);
// => [16, 64] (无法保证遍历的顺序)
var users = [
{ 'user': 'barney' },
{ 'user': 'fred' }
];
// 使用了 `_.property` 的回调结果
_.map(users, 'user');
// => ['barney', 'fred']