?
本文檔使用 PHP中文網(wǎng)手冊(cè) 發(fā)布
_.countBy(collection, iteratee=_.identity)
創(chuàng)建一個(gè)由運(yùn)行集合中的每個(gè)元素到迭代器的結(jié)果生成的鍵組成的對(duì)象。每個(gè)鍵的相應(yīng)值是密鑰返回的次數(shù)iteratee。迭代器調(diào)用一個(gè)參數(shù)：（value）。
初始
0.5.0
參數(shù)
collection（Array | Object）：迭代的集合。[iteratee=_.identity]（Function）：用于轉(zhuǎn)換密鑰的迭代器。
返回
（Object）：返回組合的聚合對(duì)象。
例
_.countBy([6.1, 4.2, 6.3], Math.floor);
// => { '4': 1, '6': 2 }
// The `_.property` iteratee shorthand.
_.countBy(['one', 'two', 'three'], 'length');
// => { '3': 2, '5': 1 }_.every(collection, predicate=_.identity)
檢查是否對(duì)于collection所有元素,predicate返回true 。一旦predicate返回falsey，迭代就會(huì)停止。謂詞用三個(gè)參數(shù)調(diào)用：（value，index | key，collection）。
注意：此方法返回true的空集，因?yàn)槭且磺卸际钦娴目占脑亍?/p>
初始
0.1.0
參數(shù)
collection（Array | Object）：迭代的集合。[predicate=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。
返回
（boolean）：所有元素是否通過(guò)了謂詞檢查則返回true，否則false。
例
_.every([true, 1, null, 'yes'], Boolean);
// => false var users = [ { 'user': 'barney', 'age': 36, 'active': false }, { 'user': 'fred', 'age': 40, 'active': false }];
// The `_.matches` iteratee shorthand.
_.every(users, { 'user': 'barney', 'active': false });
// => false
// The `_.matchesProperty` iteratee shorthand.
_.every(users, ['active', false]);
// => true
// The `_.property` iteratee shorthand.
_.every(users, 'active');
// => false_.filter(collection, predicate=_.identity)
迭代集合的元素，返回謂詞，返回truthy的所有元素的數(shù)組。謂詞用三個(gè)參數(shù)調(diào)用：（value，index | key，collection）。
注意： 與_.remove此不同，此方法返回一個(gè)新數(shù)組。
初始
0.1.0
參數(shù)
collection（Array | Object）：迭代的集合。[predicate=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。
返回
（Array）：返回新的過(guò)濾數(shù)組。
例
var users = [ { 'user': 'barney', 'age': 36, 'active': true }, { 'user': 'fred', 'age': 40, 'active': false }];
_.filter(users, function(o) { return !o.active; });
// => objects for ['fred']
// The `_.matches` iteratee shorthand.
_.filter(users, { 'age': 36, 'active': true });
// => objects for ['barney']
// The `_.matchesProperty` iteratee shorthand.
_.filter(users, ['active', false]);
// => objects for ['fred']
// The `_.property` iteratee shorthand.
_.filter(users, 'active');
// => objects for ['barney']_.find(collection, predicate=_.identity, fromIndex=0)
迭代集合的元素，返回第一個(gè)元素謂詞，返回truthy。 謂詞用三個(gè)參數(shù)調(diào)用：（value，index | key，collection）。
初始
0.1.0
參數(shù)
collection（Array | Object）：要檢查的集合。[predicate=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。[fromIndex=0]（number）：從中搜索的索引。
返回
（*）：返回匹配的元素，否則返回undefined。
例
var users = [ { 'user': 'barney', 'age': 36, 'active': true }, { 'user': 'fred', 'age': 40, 'active': false }, { 'user': 'pebbles', 'age': 1, 'active': true }];
_.find(users, function(o) { return o.age < 40; });
// => object for 'barney'
// The `_.matches` iteratee shorthand.
_.find(users, { 'age': 1, 'active': true });
// => object for 'pebbles'
// The `_.matchesProperty` iteratee shorthand.
_.find(users, ['active', false]);
// => object for 'fred'
// The `_.property` iteratee shorthand.
_.find(users, 'active');
// => object for 'barney'_.findLast(collection, predicate=_.identity, fromIndex=collection.length-1)
這個(gè)方法就像_.find，不同的是它遍歷collection從右到左的元素 。
初始
2.0.0
參數(shù)
collection（Array | Object）：要檢查的集合。[predicate=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。[fromIndex=collection.length-1]（number）：從中搜索的索引。
返回
（*）：返回匹配的元素，否則返回undefined。
例
_.findLast([1, 2, 3, 4], function(n) { return n % 2 == 1;});// => 3_.flatMap(collection, iteratee=_.identity)
通過(guò)在迭代中運(yùn)行collection中的每個(gè)元素并壓扁映射的結(jié)果來(lái)創(chuàng)建一個(gè)扁平化的值數(shù)組。迭代器被調(diào)用三個(gè)參數(shù)：（value，index | key，collection）。
初始
4.0.0
參數(shù)
collection（Array | Object）：迭代的集合。[iteratee=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。
返回
（Array）：返回新的展平數(shù)組。
例
function duplicate(n) { return [n, n];}
_.flatMap([1, 2], duplicate);// => [1, 1, 2, 2]_.flatMapDeep(collection, iteratee=_.identity)
這種方法就像_.flatMap，不同的是它遞歸地平整映射結(jié)果。
初始
4.7.0
參數(shù)
collection（Array | Object）：迭代的集合。[iteratee=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。
返回
（Array）：返回新的展平數(shù)組。
例
function duplicate(n) { return [[[n, n]]];}
_.flatMapDeep([1, 2], duplicate);// => [1, 1, 2, 2]_.flatMapDepth(collection, iteratee=_.identity, depth=1)
這種方法就像_.flatMap,不同的是它遞歸地將映射的結(jié)果平展到depth時(shí)間。
初始
4.7.0
參數(shù)
collection（Array | Object）：迭代的集合。[iteratee=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。[depth=1]（數(shù)字）：最大遞歸深度。
返回
（數(shù)組）：返回新的展平數(shù)組。
例
function duplicate(n) { return [[[n, n]]];}
_.flatMapDepth([1, 2], duplicate, 2);
// => [[1, 1], [2, 2]]_.forEach(collection, iteratee=_.identity)
迭代元素collection與iteratee為每個(gè)元素調(diào)用。迭代器調(diào)用三個(gè)參數(shù)：（value，index | key，collection）。迭代器函數(shù)可以通過(guò)顯式提前退出迭代，返回false。
注意：與其他“集合”方法一樣，具有“長(zhǎng)度”屬性的對(duì)象與數(shù)組一樣迭代。為了避免這種行為，使用_.forIn或_.forOwn用于對(duì)象迭代。
初始
0.1.0
別名
_.each
參數(shù)
collection（Array | Object）：迭代的集合。[iteratee=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。
返回
(*): 返回 collection.
例
_.forEach([1, 2], function(value) {
console.log(value);});
// => Logs `1` then `2`.
_.forEach({ 'a': 1, 'b': 2 }, function(value, key) {
console.log(key);});
// => Logs 'a' then 'b' (iteration order is not guaranteed)._.forEachRight(collection, iteratee=_.identity)
這個(gè)方法就像_.forEach，不同的是它遍歷collection 從右到左的元素。
初始
2.0.0
別名
_.eachRight
參數(shù)
collection（Array | Object）：迭代的集合。[iteratee=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。
返回
(*): 返回collection.
例
_.forEachRight([1, 2], function(value) {
console.log(value);});
// => Logs `2` then `1`._.groupBy(collection, iteratee=_.identity)
創(chuàng)建一個(gè)由運(yùn)行集合中的每個(gè)元素到迭代器的結(jié)果生成的鍵組成的對(duì)象。 分組值的順序由它們?cè)谑占邪l(fā)生的順序決定。每個(gè)鍵的相應(yīng)值是負(fù)責(zé)生成鍵的元素?cái)?shù)組。迭代器被調(diào)用一個(gè)參數(shù)：（value）。
初始
0.1.0
參數(shù)
collection（Array | Object）：迭代的集合。[iteratee=_.identity]（函數(shù)）：用于轉(zhuǎn)換密鑰的迭代器。
返回
（Object）：返回組合的聚合對(duì)象。
例
_.groupBy([6.1, 4.2, 6.3], Math.floor);
// => { '4': [4.2], '6': [6.1, 6.3] }
// The `_.property` iteratee shorthand.
_.groupBy(['one', 'two', 'three'], 'length');
// => { '3': ['one', 'two'], '5': ['three'] }_.includes(collection, value, fromIndex=0)
檢查值是否在集合中。 如果collection是一個(gè)字符串，則檢查是否有值的子字符串，否則使用SameValueZero進(jìn)行相等性比較。 如果fromIndex為負(fù)數(shù)，它將用作從收集結(jié)束的偏移量。
初始
0.1.0
參數(shù)
collection（Array | Object | string）：要檢查的集合。value（*）：要搜索的值。[fromIndex=0]（數(shù)字）：從中搜索的索引。
返回
(boolean): 如果找到值，則返回true，否則返回false。
例
_.includes([1, 2, 3], 1);// => true
_.includes([1, 2, 3], 1, 2);// => false
_.includes({ 'a': 1, 'b': 2 }, 1);// => true
_.includes('abcd', 'bc');// => true_.invokeMap(collection, path, args)
在集合中每個(gè)元素的路徑上調(diào)用該方法，返回每個(gè)調(diào)用方法的結(jié)果數(shù)組。 任何額外的參數(shù)都提供給每個(gè)調(diào)用的方法。 如果path是一個(gè)函數(shù)，那么它將被調(diào)用并綁定到集合中的每個(gè)元素。
初始
4.0.0
參數(shù)
collection（Array | Object）：迭代的集合。path（Array | Function | string）：要調(diào)用的方法的路徑或每次迭代調(diào)用的函數(shù)。[args]（... *）：用來(lái)調(diào)用每個(gè)方法的參數(shù)。
返回
（數(shù)組）：返回結(jié)果數(shù)組。
例
_.invokeMap([[5, 1, 7], [3, 2, 1]], 'sort'); // => [[1, 5, 7], [1, 2, 3]] _.invokeMap([123, 456], String.prototype.split, ''); // => [['1', '2', '3'], ['4', '5', '6']]
_.keyBy(collection, iteratee=_.identity)
創(chuàng)建一個(gè)由運(yùn)行集合中的每個(gè)元素到迭代器的結(jié)果生成的鍵組成的對(duì)象。 每個(gè)鍵的相應(yīng)值是負(fù)責(zé)生成密鑰的最后一個(gè)元素。 迭代器被調(diào)用一個(gè)參數(shù)：（value）。
初始
4.0.0
參數(shù)
collection（Array | Object）：迭代的集合。[iteratee=_.identity]（函數(shù)）：用于轉(zhuǎn)換密鑰的迭代器。
返回
（Object）：返回組合的聚合對(duì)象。
例
var array = [ { 'dir': 'left', 'code': 97 }, { 'dir': 'right', 'code': 100 }];
_.keyBy(array, function(o) { return String.fromCharCode(o.code);});
// => { 'a': { 'dir': 'left', 'code': 97 }, 'd': { 'dir': 'right', 'code': 100 } }
_.keyBy(array, 'dir');
// => { 'left': { 'dir': 'left', 'code': 97 }, 'right': { 'dir': 'right', 'code': 100 } }_.map(collection, iteratee=_.identity)
通過(guò)運(yùn)行iteratee中的每個(gè)元素來(lái)創(chuàng)建一個(gè)值的數(shù)組。 迭代器被調(diào)用三個(gè)參數(shù)：
(value, index|key, collection).
可以用許多l(xiāng)odash方法防護(hù)，iteratees工作如下：_.every，_.filter， _.map，_.mapValues，_.reject，和_.some。
防護(hù)的方法是：
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
初始
0.1.0
參數(shù)
collection（Array | Object）：迭代的集合。[iteratee=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。
返回
（Array）：返回新的映射數(shù)組。
例
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']_.orderBy(collection, [iteratees=_.identity], orders)
此方法與_.sortBy類(lèi)似，只是它允許指定要排序的迭代的排序順序。 如果訂單未指定，則所有值均按升序排序。 否則，請(qǐng)指定“desc”的降序順序或“asc”順序的升序順序。
初始
4.0.0
參數(shù)
collection（Array | Object）：迭代的集合。[iteratees=[_.identity]]（Array [] | Function [] | Object [] | string []）：要進(jìn)行排序的迭代。[orders]（string []）：的排序順序iteratees。
返回
（Array）：返回新的排序數(shù)組。
例
var users = [ { 'user': 'fred', 'age': 48 }, { 'user': 'barney', 'age': 34 }, { 'user': 'fred', 'age': 40 }, { 'user': 'barney', 'age': 36 }];
// Sort by `user` in ascending order and by `age` in descending order.
_.orderBy(users, ['user', 'age'], ['asc', 'desc']);
// => objects for [['barney', 36], ['barney', 34], ['fred', 48], ['fred', 40]]_.partition(collection, predicate=_.identity)
創(chuàng)建一個(gè)分成兩組的元素?cái)?shù)組，其中第一個(gè)包含謂詞返回truthy for的元素，第二個(gè)包含predicate返回falsey的元素。 謂詞用一個(gè)參數(shù)調(diào)用：（value）。
初始
3.0.0
參數(shù)
collection（Array | Object）：迭代的集合。[predicate=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。
返回
（Array）：返回分組元素的數(shù)組。
例
var users = [ { 'user': 'barney', 'age': 36, 'active': false }, { 'user': 'fred', 'age': 40, 'active': true }, { 'user': 'pebbles', 'age': 1, 'active': false }];
_.partition(users, function(o) { return o.active; });
// => objects for [['fred'], ['barney', 'pebbles']]
// The `_.matches` iteratee shorthand.
_.partition(users, { 'age': 1, 'active': false });
// => objects for [['pebbles'], ['barney', 'fred']]
// The `_.matchesProperty` iteratee shorthand.
_.partition(users, ['active', false]);
// => objects for [['barney', 'pebbles'], ['fred']]
// The `_.property` iteratee shorthand.
_.partition(users, 'active');
// => objects for [['fred'], ['barney', 'pebbles']]_.reduce(collection, iteratee=_.identity, accumulator)
將集合減少到一個(gè)值，該值是通過(guò)迭代器運(yùn)行collection中的每個(gè)元素的累積結(jié)果，其中每個(gè)連續(xù)的調(diào)用都提供了前一個(gè)的返回值。 如果沒(méi)有累加器，則采集的第一個(gè)元素被用作初始值。 迭代器被調(diào)用四個(gè)參數(shù)：
(accumulator, value, index|key, collection).
有許多l(xiāng)odash方法防護(hù)，iteratees的方法如_.reduce，_.reduceRight和_.transform。
防護(hù)的方法是：
assign, defaults, defaultsDeep, includes, merge, orderBy, and sortBy
初始
0.1.0
參數(shù)
collection（Array | Object）：迭代的集合。[iteratee=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。[accumulator]（*）：初始值。
返回
（*）：返回累計(jì)值。
例
_.reduce([1, 2], function(sum, n) { return sum + n;}, 0);// => 3
_.reduce({ 'a': 1, 'b': 2, 'c': 1 }, function(result, value, key) { (result[value] || (result[value] = [])).push(key);
return result;}, {});
// => { '1': ['a', 'c'], '2': ['b'] } (iteration order is not guaranteed)_.reduceRight(collection, iteratee=_.identity, accumulator)
這個(gè)方法就像_.reduce，不同的是它遍歷collection 從右到左的元素。
初始
0.1.0
參數(shù)
collection（Array | Object）：迭代的集合。[iteratee=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。[accumulator]（*）：初始值。
返回
（*）：返回累計(jì)值。
例
var array = [[0, 1], [2, 3], [4, 5]];
_.reduceRight(array, function(flattened, other) { return flattened.concat(other);}, []);
// => [4, 5, 2, 3, 0, 1]_.reject(collection, predicate=_.identity)
與_.filter相反; 此方法返回謂詞不返回真值的集合元素。
初始
0.1.0
參數(shù)
collection（Array | Object）：迭代的集合。[predicate=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。
返回
（數(shù)組）：返回新的過(guò)濾數(shù)組。
例
var users = [ { 'user': 'barney', 'age': 36, 'active': false }, { 'user': 'fred', 'age': 40, 'active': true }];
_.reject(users, function(o) { return !o.active; });
// => objects for ['fred']
// The `_.matches` iteratee shorthand.
_.reject(users, { 'age': 40, 'active': true });
// => objects for ['barney']
// The `_.matchesProperty` iteratee shorthand.
_.reject(users, ['active', false]);
// => objects for ['fred']
// The `_.property` iteratee shorthand.
_.reject(users, 'active');
// => objects for ['barney']_.sample(collection)
從collection中取一個(gè)隨機(jī)元素。
初始
2.0.0
參數(shù)
collection（Array | Object）：要采樣的集合。
返回
（*）：返回隨機(jī)元素。
例
_.sample([1, 2, 3, 4]);// => 2
_.sampleSize(collection, n=1)
獲取集合中唯一鍵的n個(gè)隨機(jī)元素（大小不等）
初始
4.0.0
參數(shù)
collection（Array | Object）：要采樣的集合。[n=1]（數(shù)字）：要采樣的元素?cái)?shù)量。
返回
（數(shù)組）：返回隨機(jī)元素。
例
_.sampleSize([1, 2, 3], 2);// => [3, 1] _.sampleSize([1, 2, 3], 4);// => [2, 3, 1]
_.shuffle(collection)
使用Fisher-Yates shuffle版本創(chuàng)建一個(gè)混合值數(shù)組。
初始
0.1.0
參數(shù)
collection（Array | Object）：要刷新的集合。
返回
（數(shù)組）：返回新的混洗數(shù)組。
例
_.shuffle([1, 2, 3, 4]);// => [4, 1, 3, 2]
_.size(collection)
通過(guò)返回對(duì)象的數(shù)組類(lèi)型值的長(zhǎng)度或自己的可枚舉字符串鍵控屬性的數(shù)量來(lái)獲取集合的大小。
初始
0.1.0
參數(shù)
collection（Array | Object | string）：要檢查的集合。
返回
（數(shù)字）：返回集合大小。
例
_.size([1, 2, 3]);// => 3
_.size({ 'a': 1, 'b': 2 });// => 2
_.size('pebbles');// => 7_.some(collection, predicate=_.identity)
檢查predicate是否返回任何collection的元素。 一旦謂詞返回真，迭代就會(huì)停止。 謂詞用三個(gè)參數(shù)調(diào)用：（value，index | key，collection）。
初始
0.1.0
參數(shù)
collection（Array | Object）：迭代的集合。[predicate=_.identity]（Function）：每次迭代調(diào)用的函數(shù)。
返回
（boolean）：若有元素通過(guò)謂詞檢查，返回true，否則false。
例
_.some([null, 0, 'yes', false], Boolean);
// => true var users = [ { 'user': 'barney', 'active': true }, { 'user': 'fred', 'active': false }];
// The `_.matches` iteratee shorthand.
_.some(users, { 'user': 'barney', 'active': false });
// => false
// The `_.matchesProperty` iteratee shorthand.
_.some(users, ['active', false]);
// => true
// The `_.property` iteratee shorthand.
_.some(users, 'active');
// => true_.sortBy(collection, [iteratees=_.identity])
創(chuàng)建一個(gè)元素?cái)?shù)組，按照每個(gè)迭代器運(yùn)行集合中每個(gè)元素的結(jié)果按升序排序。此方法執(zhí)行穩(wěn)定的排序，即保留相同元素的原始排序順序。迭代被調(diào)用一個(gè)參數(shù)：（value）。
初始
0.1.0
參數(shù)
collection（Array | Object）：迭代的集合。[iteratees=[_.identity]]（...（Function | Function []））：按迭代排序。
返回
（Array）：返回新的排序數(shù)組。
例
var users = [ { 'user': 'fred', 'age': 48 }, { 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }, { 'user': 'barney', 'age': 34 }];
_.sortBy(users, [function(o) { return o.user; }]);// => objects for [['barney', 36], ['barney', 34], ['fred', 48], ['fred', 40]]
_.sortBy(users, ['user', 'age']);// => objects for [['barney', 34], ['barney', 36], ['fred', 40], ['fred', 48]]