Array
- _.chunk(array, [size=1])
将数组拆分成多个size长度的区块，并将这些区块组成一个新数组。 如果数组无法被分割成全部等长的区块，那么最后剩余的元素将组成一个区块。
不修改原数组，返回一个包含拆分区块的新数组（注：相当于一个二维数组）。
_.chunk(['a', 'b', 'c', 'd'], 2);
// => [['a', 'b'], ['c', 'd']]
_.chunk(['a', 'b', 'c', 'd'], 3);
// => [['a', 'b', 'c'], ['d']]
- _.compact(array)
创建一个新数组，包含原数组中所有的非假值元素。例如false, null, 0, "", undefined, 和NaN都是被认为是“假值”。
不修改原数组，返回过滤掉假值的新数组。
- _.difference(array, [values])
创建一个新数组，这个数组中的值，为第一个参数排除了给定数组中的值。结果值的顺序是由第一个数组中的顺序确定。
不像 _.pullAll(array, values)，该方法不修改原数组，返回一个过滤值后的新数组。
_.difference([2, 1], [2, 3]);
// => [1]
- _.flattenDepth(array, [depth=1])
根据depth递归减少数组的嵌套层级（注：即数组扁平化）。
不修改原数组，返回减少嵌套层级后的新数组。
- _.sortedIndex(array, value)
使用二进制的方式检索来决定value值应该插入到数组中尽可能小的索引位置，以保证数组的排序。
返回value值 应该在数组中插入的索引位置。
_.sortedIndex([30, 50], 40);
// => 1
- _.union([arrays])
数组的并集，按顺序返回，返回数组的元素是唯一的。
返回一个新的联合数组。
- _.uniq(array)
创建一个去重后的数组副本（注：即数组去重）。
不修改原数组，返回新的去重后的数组。
- _.zip([arrays])
创建一个分组元素的数组，数组的第一个元素包含所有给定数组的第一个元素，数组的第二个元素包含所有给定数组的第二个元素，以此类推（注：即数组转置）。
返回分组元素的新数组。
_.zip(['fred', 'barney'], [30, 40], [true, false]);
// => [['fred', 30, true], ['barney', 40, false]]
- _.zipObject([props=[]], [values=[]])
它接受2个数组，第一个数组中的值作为属性名，第二个数组中的值作为相应的属性值（注：即将两个数组用键值对关联）。
返回一个新的对象。
_.zipObject(['a', 'b'], [1, 2]);
// => { 'a': 1, 'b': 2 }
Collection (Array|Object)
- .groupBy(collection, [iteratee=.identity])
创建一个集合对象，对象的键是经过迭代函数（iteratee）执行处理集合中每个元素后返回的结果，每个键对应的值负责生成键的元素组成的数组。
返回一个新的集合对象。
_.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'] }
- .orderBy(collection, [iteratees=[.identity]], [orders])
对集合通过迭代函数来进行排序，若没指定orders，所有值以升序排序。 否则，指定为desc 降序，或者指定为asc升序。
返回排序后的新数组。
var users = [
{ 'user': 'fred', 'age': 48 },
{ 'user': 'barney', 'age': 34 },
{ 'user': 'fred', 'age': 40 },
{ 'user': 'barney', 'age': 36 }
];
// 以 `user` 升序排序 再 `age` 以降序排序。
_.orderBy(users, ['user', 'age'], ['asc', 'desc']);
// => objects for [['barney', 36], ['barney', 34], ['fred', 48], ['fred', 40]]
Function
- _.curry(func, [arity=func.length])
var abc = function(a, b, c) {
return [a, b, c];
};
var curried = _.curry(abc);
curried(1)(2)(3);
// => [1, 2, 3]
curried(1, 2)(3);
// => [1, 2, 3]
curried(1, 2, 3);
// => [1, 2, 3]
// Curried with placeholders.
curried(1)(_, 3)(2);
// => [1, 2, 3]
- _.debounce(func, [wait=0], [options={}])
// 避免窗口在变动时出现昂贵的计算开销。
jQuery(window).on('resize', _.debounce(calculateLayout, 150));
// 当点击时 `sendMail` 随后就被调用。
jQuery(element).on('click', _.debounce(sendMail, 300, {
'leading': true,
'trailing': false
}));
// 确保 `batchLog` 调用1次之后，1秒内会被触发。
var debounced = _.debounce(batchLog, 250, { 'maxWait': 1000 });
var source = new EventSource('/stream');
jQuery(source).on('message', debounced);
// 取消一个 trailing 的防抖动调用
jQuery(window).on('popstate', debounced.cancel);
- _.delay(func, wait, [args])
_.delay(function(text) {
console.log(text);
}, 1000, 'later');
// => Logs 'later' after one second.
- _.once(func)
var initialize = _.once(createApplication);
initialize();
initialize();
// => `createApplication` is invoked once
- _.throttle(func, [wait=0], [options={}])
// 避免在滚动时过分的更新定位
jQuery(window).on('scroll', _.throttle(updatePosition, 100));
// 点击后就调用 `renewToken`，但5分钟内超过1次。
var throttled = _.throttle(renewToken, 300000, { 'trailing': false });
jQuery(element).on('click', throttled);
// 取消一个 trailing 的节流调用。
jQuery(window).on('popstate', throttled.cancel);
- _.wrap(value, [wrapper=identity])
var p = _.wrap(_.escape, function(func, text) {
return '' + func(text) + '
';
});
p('fred, barney, & pebbles');
// => 'fred, barney, & pebbles
'