Lodash 中文文档 请选择版本 v4.16.1 v4.15.0

_.chunk(array, [size=1])

Ⓢ Ⓝ

将数组（array）拆分成多个 size 长度的区块，并将这些区块组成一个新数组。 如果array 无法被分割成全部等长的区块，那么最后剩余的元素将组成一个区块。

引入版本

3.0.0

参数

1. array (Array): 需要处理的数组
2. [size=1] (number): 每个数组区块的长度

返回

(Array): 返回一个包含拆分区块的新数组（愚人码头注：相当于一个二维数组）。

例子

_.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 都是被认为是“假值”。

引入版本

0.1.0

参数

1. array (Array): 待处理的数组

返回值

(Array): 返回过滤掉假值的新数组。

例子

_.compact([0, 1, false, 2, '', 3]);
// => [1, 2, 3]

_.concat(array, [values])

Ⓢ Ⓝ

创建一个新数组，将array与任何数组 或 值连接在一起。

引入版本

4.0.0

参数

1. array (Array): 被连接的数组。
2. [values] (...*): 连接的值。

返回值

(Array): 返回连接后的新数组。

例子

var array = [1];
var other = _.concat(array, 2, [3], [[4]]);
 
console.log(other);
// => [1, 2, 3, [4]]
 
console.log(array);
// => [1]

_.difference(array, [values])

Ⓢ Ⓝ

创建一个具有唯一array值的数组，每个值不包含在其他给定的数组中。（愚人码头注：即创建一个新数组，这个数组中的值，为第一个数字（array 参数）排除了给定数组中的值。）该方法使用 SameValueZero做相等比较。结果值的顺序是由第一个数组中的顺序确定。

注意: 不像 _.pullAll，这个方法会返回一个新数组。

引入版本

0.1.0

参数

1. array (Array): 要检查的数组。
2. [values] (...Array): 排除的值。

返回值

(Array): 返回一个过滤值后的新数组。

例子

_.difference([3, 2, 1], [4, 2]);
// => [3, 1]

_.differenceBy(array, [values], [iteratee=_.identity])

Ⓢ Ⓝ

这个方法类似 _.difference ，除了它接受一个 iteratee （愚人码头注：迭代器）， 调用array 和 values 中的每个元素以产生比较的标准。 结果值是从第一数组中选择。iteratee 会调用一个参数：(value)。（愚人码头注：首先使用迭代器分别迭代array 和 values中的每个元素，返回的值作为比较值）。

Note: 不像 _.pullAllBy，这个方法会返回一个新数组。

引入版本

4.0.0

参数

1. array (Array): 要检查的数组。
2. [values] (...Array): 排除的值。
3. [iteratee=_.identity] (Array|Function|Object|string): iteratee 调用每个元素。

返回值

(Array): 返回一个过滤值后的新数组。

例子

_.differenceBy([3.1, 2.2, 1.3], [4.4, 2.5], Math.floor);
// => [3.1, 1.3]
 
// The `_.property` iteratee shorthand.
_.differenceBy([{ 'x': 2 }, { 'x': 1 }], [{ 'x': 1 }], 'x');
// => [{ 'x': 2 }]

_.differenceWith(array, [values], [comparator])

Ⓢ Ⓝ

这个方法类似 _.difference ，除了它接受一个 comparator （愚人码头注：比较器），它调用比较array，values中的元素。 结果值是从第一数组中选择。comparator 调用参数有两个：(arrVal, othVal)。

Note: 不像 _.pullAllWith, 这个方法会返回一个新数组。

引入版本

4.0.0

参数

1. array (Array): 要检查的数组。
2. [values] (...Array): 排除的值。
3. [comparator] (Function): comparator 调用每个元素。

返回值

(Array): 返回一个过滤值后的新数组。

例子

var objects = [{ 'x': 1, 'y': 2 }, { 'x': 2, 'y': 1 }];
 
_.differenceWith(objects, [{ 'x': 1, 'y': 2 }], _.isEqual);
// => [{ 'x': 2, 'y': 1 }]

_.drop(array, [n=1])

Ⓢ Ⓝ

创建一个切片数组，去除array前面的n个元素。（n默认值为1。）

引入版本

0.5.0

参数

1. array (Array): 要查询的数组。
2. [n=1] (number): 要去除的元素个数。

返回值

(Array): 返回array剩余切片。

例子

_.drop([1, 2, 3]);
// => [2, 3]
 
_.drop([1, 2, 3], 2);
// => [3]
 
_.drop([1, 2, 3], 5);
// => []
 
_.drop([1, 2, 3], 0);
// => [1, 2, 3]

_.dropRight(array, [n=1])

Ⓢ Ⓝ

创建一个切片数组，去除array尾部的n个元素。（n默认值为1。）

引入版本

3.0.0

参数

1. array (Array): 要查询的数组。
2. [n=1] (number): 要去除的元素个数。

返回值

(Array): 返回array剩余切片。

例子

_.dropRight([1, 2, 3]);
// => [1, 2]
 
_.dropRight([1, 2, 3], 2);
// => [1]
 
_.dropRight([1, 2, 3], 5);
// => []
 
_.dropRight([1, 2, 3], 0);
// => [1, 2, 3]

_.dropRightWhile(array, [predicate=_.identity])

Ⓢ Ⓝ

创建一个切片数组，去除array中从 predicate 返回假值开始到尾部的部分。predicate 会传入3个参数： (value, index, array)。

引入版本

3.0.0

参数

1. array (Array): 要查询的数组。
2. [predicate=_.identity] (Function): 这个函数会在每一次迭代调用。

返回值

(Array): 返回array剩余切片。

例子

var users = [
  { 'user': 'barney',  'active': true },
  { 'user': 'fred',    'active': false },
  { 'user': 'pebbles', 'active': false }
];
 
_.dropRightWhile(users, function(o) { return !o.active; });
// => objects for ['barney']
 
// The `_.matches` iteratee shorthand.
_.dropRightWhile(users, { 'user': 'pebbles', 'active': false });
// => objects for ['barney', 'fred']
 
// The `_.matchesProperty` iteratee shorthand.
_.dropRightWhile(users, ['active', false]);
// => objects for ['barney']
 
// The `_.property` iteratee shorthand.
_.dropRightWhile(users, 'active');
// => objects for ['barney', 'fred', 'pebbles']

_.dropWhile(array, [predicate=_.identity])

Ⓢ Ⓝ

创建一个切片数组，去除array中从起点开始到 predicate 返回假值结束部分。predicate 会传入3个参数： (value, index, array)。

引入版本

3.0.0

参数

1. array (Array): 要查询的数组。
2. [predicate=_.identity] (Function): 这个函数会在每一次迭代调用。

返回值

(Array): 返回array剩余切片。

例子

var users = [
  { 'user': 'barney',  'active': false },
  { 'user': 'fred',    'active': false },
  { 'user': 'pebbles', 'active': true }
];
 
_.dropWhile(users, function(o) { return !o.active; });
// => objects for ['pebbles']
 
// The `_.matches` iteratee shorthand.
_.dropWhile(users, { 'user': 'barney', 'active': false });
// => objects for ['fred', 'pebbles']
 
// The `_.matchesProperty` iteratee shorthand.
_.dropWhile(users, ['active', false]);
// => objects for ['pebbles']
 
// The `_.property` iteratee shorthand.
_.dropWhile(users, 'active');
// => objects for ['barney', 'fred', 'pebbles']

_.fill(array, value, [start=0], [end=array.length])

Ⓢ Ⓝ

使用 value 值来填充（替换） array，从start位置开始, 到end位置结束（但不包含end位置）。

Note: 这个方法会改变 array（愚人码头注：不是创建新数组）。

引入版本

3.2.0

参数

1. array (Array): 要填充改变的数组。
2. value (*): 填充给 array 的值。
3. [start=0] (number): 开始位置（默认0）。
4. [end=array.length] (number):结束位置（默认array.length）。

返回值

(Array): 返回 array。

例子

var array = [1, 2, 3];
 
_.fill(array, 'a');
console.log(array);
// => ['a', 'a', 'a']
 
_.fill(Array(3), 2);
// => [2, 2, 2]
 
_.fill([4, 6, 8, 10], '*', 1, 3);
// => [4, '*', '*', 10]

_.findIndex(array, [predicate=_.identity], [fromIndex=0])

Ⓢ Ⓝ

该方法类似 _.find，区别是该方法返回第一个通过 predicate 判断为真值的元素的索引值（index），而不是元素本身。

引入版本

1.1.0

参数

1. array (Array): 要搜索的数组。
2. [predicate=_.identity] (Array|Function|Object|string): 这个函数会在每一次迭代调用。
3. [fromIndex=0] (number): The index to search from.

返回值

(number): 返回找到元素的 索引值（index），否则返回 -1。

例子

var users = [
  { 'user': 'barney',  'active': false },
  { 'user': 'fred',    'active': false },
  { 'user': 'pebbles', 'active': true }
];
 
_.findIndex(users, function(o) { return o.user == 'barney'; });
// => 0
 
// The `_.matches` iteratee shorthand.
_.findIndex(users, { 'user': 'fred', 'active': false });
// => 1
 
// The `_.matchesProperty` iteratee shorthand.
_.findIndex(users, ['active', false]);
// => 0
 
// The `_.property` iteratee shorthand.
_.findIndex(users, 'active');
// => 2

_.findLastIndex(array, [predicate=_.identity], [fromIndex=array.length-1])

Ⓢ Ⓝ

这个方式类似 _.findIndex， 区别是它是从右到左的迭代集合array中的元素。

引入版本

2.0.0

参数

1. array (Array): 要搜索的数组。
2. [predicate=_.identity] (Array|Function|Object|string): 这个函数会在每一次迭代调用。
3. [fromIndex=array.length-1] (number): The index to search from.

返回值

(number): 返回找到元素的 索引值（index），否则返回 -1。

例子

var users = [
  { 'user': 'barney',  'active': true },
  { 'user': 'fred',    'active': false },
  { 'user': 'pebbles', 'active': false }
];
 
_.findLastIndex(users, function(o) { return o.user == 'pebbles'; });
// => 2
 
// The `_.matches` iteratee shorthand.
_.findLastIndex(users, { 'user': 'barney', 'active': true });
// => 0
 
// The `_.matchesProperty` iteratee shorthand.
_.findLastIndex(users, ['active', false]);
// => 2
 
// The `_.property` iteratee shorthand.
_.findLastIndex(users, 'active');
// => 0

_.flatten(array)

Ⓢ Ⓝ

减少一级array嵌套深度。

引入版本

0.1.0

参数

1. array (Array): 需要减少嵌套层级的数组。

返回值

(Array): 返回减少嵌套层级后的新数组。

例子

_.flatten([1, [2, [3, [4]], 5]]);
// => [1, 2, [3, [4]], 5]

_.flattenDeep(array)

Ⓢ Ⓝ

将array递归为一维数组。

引入版本

3.0.0

参数

1. array (Array): 需要处理的数组。

返回值

(Array): 返回一个的新一维数组。

例子

_.flattenDeep([1, [2, [3, [4]], 5]]);
// => [1, 2, 3, 4, 5]

_.flattenDepth(array, [depth=1])

Ⓢ Ⓝ

根据 depth 递归减少 array 的嵌套层级

引入版本

4.4.0

参数

1. array (Array): 需要减少嵌套层级的数组。
2. [depth=1] (number):最多减少的嵌套层级数。

返回值

(Array): 返回减少嵌套层级后的新数组。

例子

var array = [1, [2, [3, [4]], 5]];
 
_.flattenDepth(array, 1);
// => [1, 2, [3, [4]], 5]
 
_.flattenDepth(array, 2);
// => [1, 2, 3, [4], 5]

_.fromPairs(pairs)

Ⓢ Ⓝ

与 _.toPairs正好相反；这个方法返回一个由键值对pairs构成的对象。

引入版本

4.0.0

参数

1. pairs (Array): 键值对pairs。

返回值

(Object): 返回一个新对象。

例子

_.fromPairs([['fred', 30], ['barney', 40]]);
// => { 'fred': 30, 'barney': 40 }

_.head(array)

Ⓢ Ⓝ

获取数组 array 的第一个元素。

引入版本

0.1.0

别名

_.first

参数

1. array (Array): 要查询的数组。

返回值

(*): 返回数组 array的第一个元素。

例子

_.head([1, 2, 3]);
// => 1
 
_.head([]);
// => undefined

_.indexOf(array, value, [fromIndex=0])

Ⓢ Ⓝ

使用 SameValueZero 等值比较，返回首次 value 在数组array中被找到的 索引值， 如果 fromIndex 为负值，将从数组array尾端索引进行匹配。

引入版本

0.1.0

参数

1. array (Array): 需要查找的数组。
2. value (*): 需要查找的值。
3. [fromIndex=0] (number): 开始查询的位置。

返回值

(number): 返回 值value在数组中的索引位置, 没有找到为返回-1。

例子

_.indexOf([1, 2, 1, 2], 2);
// => 1
 
// Search from the `fromIndex`.
_.indexOf([1, 2, 1, 2], 2, 2);
// => 3

_.initial(array)

Ⓢ Ⓝ

获取数组array中除了最后一个元素之外的所有元素（愚人码头注：去除数组array中的最后一个元素）。

引入版本

0.1.0

参数

1. array (Array): 要查询的数组。

返回值

(Array): 返回截取后的数组array。

例子

_.initial([1, 2, 3]);
// => [1, 2]

_.intersection([arrays])

Ⓢ Ⓝ

创建唯一值的数组，这个数组包含所有给定数组都包含的元素，使用 SameValueZero进行相等性比较。（愚人码头注：可以理解为给定数组的交集）

引入版本

0.1.0

参数

1. [arrays] (...Array): 待检查的数组。

返回值

(Array): 返回一个包含所有传入数组交集元素的新数组。

例子

_.intersection([2, 1], [4, 2], [1, 2]);
// => [2]

_.intersectionBy([arrays], [iteratee=_.identity])

Ⓢ Ⓝ

这个方法类似 _.intersection，区别是它接受一个 iteratee 调用每一个arrays的每个值以产生一个值，通过产生的值进行了比较。结果值是从第一数组中选择。iteratee 会传入一个参数：(value)。

引入版本

4.0.0

参数

1. [arrays] (...Array): 待检查的数组。
2. [iteratee=_.identity] (Array|Function|Object|string): iteratee（迭代器）调用每个元素。

返回值

(Array): 返回一个包含所有传入数组交集元素的新数组。

例子

_.intersectionBy([2.1, 1.2], [4.3, 2.4], Math.floor);
// => [2.1]
 
// The `_.property` iteratee shorthand.
_.intersectionBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x');
// => [{ 'x': 1 }]

_.intersectionWith([arrays], [comparator])

Ⓢ Ⓝ

这个方法类似 _.intersection，区别是它接受一个 comparator 调用比较arrays中的元素。结果值是从第一数组中选择。comparator 会传入两个参数：(arrVal, othVal)。

引入版本

4.0.0

参数

1. [arrays] (...Array): 待检查的数组。
2. [comparator] (Function): comparator（比较器）调用每个元素。

返回值

(Array): 返回一个包含所有传入数组交集元素的新数组。

例子

var objects = [{ 'x': 1, 'y': 2 }, { 'x': 2, 'y': 1 }];
var others = [{ 'x': 1, 'y': 1 }, { 'x': 1, 'y': 2 }];
 
_.intersectionWith(objects, others, _.isEqual);
// => [{ 'x': 1, 'y': 2 }]

_.join(array, [separator=','])

Ⓢ Ⓝ

将 array 中的所有元素转换为由 separator 分隔的字符串。

引入版本

4.0.0

参数

1. array (Array): 要转换的数组。
2. [separator=','] (string): 分隔元素。

返回值

(string): 返回连接字符串。

例子

_.join(['a', 'b', 'c'], '~');
// => 'a~b~c'

_.last(array)

Ⓢ Ⓝ

获取array中的最后一个元素。

引入版本

0.1.0

参数

1. array (Array): 要检索的数组。

2. 返回值

(*): 返回array中的最后一个元素

例子

_.last([1, 2, 3]);
// => 3

_.lastIndexOf(array, value, [fromIndex=array.length-1])

Ⓢ Ⓝ

这个方法类似 _.indexOf ，区别是它是从右到左遍历array的元素。

引入版本

0.1.0

参数

1. array (Array): 要搜索的数组。
2. value (*): 要搜索的值。
3. [fromIndex=array.length-1] (number): 开始搜索的索引值。

返回值

(number): 返回匹配值的索引值，否则返回 -1。

例子

_.lastIndexOf([1, 2, 1, 2], 2);
// => 3
 
// Search from the `fromIndex`.
_.lastIndexOf([1, 2, 1, 2], 2, 2);
// => 1

_.nth(array, [n=0])

Ⓢ Ⓝ

获取array数组的第n个元素。如果n为负数，则返回从数组结尾开始的第n个元素。

引入版本

4.11.0

参数

1. array (Array): 要查询的数组。
2. [n=0] (number): 要返回元素的索引值。

返回值

(*): 获取array数组的第n个元素。

例子

var array = ['a', 'b', 'c', 'd'];
 
_.nth(array, 1);
// => 'b'
 
_.nth(array, -2);
// => 'c';

_.pull(array, [values])

Ⓢ Ⓝ

移除数组array中所有和给定值相等的元素，使用 SameValueZero 进行全等比较。

注意： 和 _.without 方法不同，这个方法会改变数组。使用 _.remove 从一个数组中移除元素。

引入版本

2.0.0

参数

1. array (Array): 要修改的数组。
2. [values] (...*): 要删除的值。

返回值

(Array): 返回 array.

例子

var array = [1, 2, 3, 1, 2, 3];
 
_.pull(array, 2, 3);
console.log(array);
// => [1, 1]

_.pullAll(array, values)

Ⓢ Ⓝ

这个方法类似 _.pull，区别是这个方法接收一个要移除值的数组。

Note: 不同于 _.difference, 这个方法会改变数组 array。

引入版本

4.0.0

参数

1. array (Array): 要修改的数组。
2. values (Array): 要移除值的数组。

返回值

(Array): 返回 array。

例子

var array = [1, 2, 3, 1, 2, 3];
 
_.pullAll(array, [2, 3]);
console.log(array);
// => [1, 1]

_.pullAllBy(array, values, [iteratee=_.identity])

Ⓢ Ⓝ

这个方法类似于 _.pullAll ，区别是这个方法接受一个 iteratee（迭代函数） 调用 array 和 values的每个值以产生一个值，通过产生的值进行了比较。iteratee 会传入一个参数： (value)。

Note: 不同于 _.differenceBy, 这个方法会改变数组 array。

引入版本

4.0.0

参数

1. array (Array): 要修改的数组。
2. values (Array): 要移除值的数组。
3. [iteratee=_.identity] (Array|Function|Object|string): iteratee（迭代器）调用每个元素。

返回值

(Array): 返回 array.

例子

var array = [{ 'x': 1 }, { 'x': 2 }, { 'x': 3 }, { 'x': 1 }];
 
_.pullAllBy(array, [{ 'x': 1 }, { 'x': 3 }], 'x');
console.log(array);
// => [{ 'x': 2 }]

_.pullAllWith(array, values, [comparator])

Ⓢ Ⓝ

这个方法类似于 _.pullAll，区别是这个方法接受 comparator 调用array中的元素和values比较。comparator 会传入两个参数：(arrVal, othVal)。

注意: 和 _.differenceWith 不同, 这个方法会改变数组 array。

引入版本

4.6.0

参数

1. array (Array): 要修改的数组。
2. values (Array): 要移除值的数组。
3. [comparator] (Function): comparator（比较器）调用每个元素。

返回值

(Array): 返回 array。

例子

var array = [{ 'x': 1, 'y': 2 }, { 'x': 3, 'y': 4 }, { 'x': 5, 'y': 6 }];
 
_.pullAllWith(array, [{ 'x': 3, 'y': 4 }], _.isEqual);
console.log(array);
// => [{ 'x': 1, 'y': 2 }, { 'x': 5, 'y': 6 }]

_.pullAt(array, [indexes])

Ⓢ Ⓝ

根据索引 indexes，移除array中对应的元素，并返回被移除元素的数组。

Note: 和 _.at不同, 这个方法会改变数组 array。

引入版本

3.0.0

参数

1. array (Array): 要修改的数组。
2. [indexes] (...(number|number[])): 要移除元素的索引。

返回值

(Array): 返回移除元素组成的新数组。

例子

var array = [5, 10, 15, 20];
var evens = _.pullAt(array, 1, 3);
 
console.log(array);
// => [5, 15]
 
console.log(evens);
// => [10, 20]

_.remove(array, [predicate=_.identity])

Ⓢ Ⓝ

移除数组中predicate（断言）返回为真值的所有元素，并返回移除元素组成的数组。predicate（断言） 会传入3个参数： (value, index, array)。

Note: 和 _.filter不同, 这个方法会改变数组 array。使用 _.pull来根据提供的value值从数组中移除元素。

添加版本

2.0.0

参数

1. array (Array): 要修改的数组。
2. [predicate=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。

返回

(Array): 返回移除元素组成的新数组。

例子

var array = [1, 2, 3, 4];
var evens = _.remove(array, function(n) {
  return n % 2 == 0;
});
 
console.log(array);
// => [1, 3]
 
console.log(evens);
// => [2, 4]

_.reverse(array)

Ⓢ Ⓝ

反转array，使得第一个元素变为最后一个元素，第二个元素变为倒数第二个元素，依次类推。

Note: 这个方法会改变原数组 array，基于 Array#reverse.

添加版本

4.0.0

参数

1. array (Array): 要修改的数组。

返回

(Array): 返回 array.

例子

var array = [1, 2, 3];
 
_.reverse(array);
// => [3, 2, 1]
 
console.log(array);
// => [3, 2, 1]

_.slice(array, [start=0], [end=array.length])

Ⓢ Ⓝ

裁剪数组array，从 start 位置开始到end结束，但不包括 end 本身的位置。

Note: 这个方法用于代替 Array#slice 来确保数组正确返回。

添加版本

3.0.0

参数

1. array (Array): 要裁剪数组。
2. [start=0] (number): 开始位置。
3. [end=array.length] (number): 结束位置。

返回

(Array): 返回 数组array 裁剪部分的新数组。

_.sortedIndex(array, value)

Ⓢ Ⓝ

使用二进制的方式检索来决定 value值 应该插入到数组中 尽可能小的索引位置，以保证array的排序。

添加版本

0.1.0

参数

1. array (Array): 要检查的排序数组。
2. value (*): 要评估的值。

返回

(number): 返回 value值 应该在数组array中插入的索引位置 index。

例子

_.sortedIndex([30, 50], 40);
// => 1

_.sortedIndexBy(array, value, [iteratee=_.identity])

Ⓢ Ⓝ

这个方法类似 _.sortedIndex ，除了它接受一个 iteratee （迭代函数），调用每一个数组（array）元素，返回结果和value 值比较来计算排序。iteratee 会传入一个参数：(value)。

添加版本

4.0.0

参数

1. array (Array): 要检查的排序数组。
2. value (*): 要评估的值。
3. [iteratee=_.identity] (Array|Function|Object|string): 迭代函数，调用每个元素。

返回

(number): 返回 value值 应该在数组array中插入的索引位置 index。

例子

var objects = [{ 'x': 4 }, { 'x': 5 }];
 
_.sortedIndexBy(objects, { 'x': 4 }, function(o) { return o.x; });
// => 0
 
// The `_.property` iteratee shorthand.
_.sortedIndexBy(objects, { 'x': 4 }, 'x');
// => 0

_.sortedIndexOf(array, value)

Ⓢ Ⓝ

这个方法类似 _.indexOf，除了它是在已经排序的数组array上执行二进制检索。

添加版本

4.0.0

参数

1. array (Array): 要搜索的数组。
2. value (*): 搜索的值。

返回

(number): 返回匹配值的索引位置，否则返回 -1。

例子

_.sortedIndexOf([4, 5, 5, 5, 6], 5);
// => 1

_.sortedLastIndex(array, value)

Ⓢ Ⓝ

此方法类似于 _.sortedIndex，除了 它返回 value值 在 array 中尽可能大的索引位置（index）。

添加版本

3.0.0

参数

1. array (Array): 要检查的排序数组。
2. value (*): 要评估的值。

返回

(number): 返回 value值 应该在数组array中插入的索引位置 index。

例子

_.sortedLastIndex([4, 5, 5, 5, 6], 5);
// => 4

_.sortedLastIndexBy(array, value, [iteratee=_.identity])

Ⓢ Ⓝ

这个方法类似 _.sortedLastIndex ，除了它接受一个 iteratee （迭代函数），调用每一个数组（array）元素，返回结果和value 值比较来计算排序。iteratee 会传入一个参数：(value)。

添加版本

4.0.0

参数

1. array (Array): 要检查的排序数组。
2. value (*): 要评估的值。
3. [iteratee=_.identity] (Array|Function|Object|string): 迭代函数，调用每个元素。

返回

(number): 返回 value值 应该在数组array中插入的索引位置 index。

例子

var objects = [{ 'x': 4 }, { 'x': 5 }];
 
_.sortedLastIndexBy(objects, { 'x': 4 }, function(o) { return o.x; });
// => 1
 
// The `_.property` iteratee shorthand.
_.sortedLastIndexBy(objects, { 'x': 4 }, 'x');
// => 1

_.sortedLastIndexOf(array, value)

Ⓢ Ⓝ

这个方法类似 _.lastIndexOf，除了它是在已经排序的数组array上执行二进制检索。

添加版本

4.0.0

参数

1. array (Array): 要搜索的数组。
2. value (*): 搜索的值。

返回

(number): 返回匹配值的索引位置，否则返回 -1。

例子

_.sortedLastIndexOf([4, 5, 5, 5, 6], 5);
// => 3

_.sortedUniq(array)

Ⓢ Ⓝ

这个方法类似 _.uniq，除了它会优化排序数组。

添加版本

4.0.0

参数

1. array (Array): 要检查的数组。

返回

(Array): 返回一个新的不重复的数组。

例子

_.sortedUniq([1, 1, 2]);
// => [1, 2]

_.sortedUniqBy(array, [iteratee])

Ⓢ Ⓝ

这个方法类似 _.uniqBy，除了它会优化排序数组。

添加版本

4.0.0

参数

1. array (Array): 要检查的数组。
2. [iteratee] (Function): 迭代函数，调用每个元素。

返回

(Array): 返回一个新的不重复的数组。

例子

_.sortedUniqBy([1.1, 1.2, 2.3, 2.4], Math.floor);
// => [1.1, 2.3]

_.tail(array)

Ⓢ Ⓝ

获取除了array数组第一个元素以外的全部元素。

添加版本

4.0.0

参数

1. array (Array): 要检索的数组。

返回

(Array): 返回 array 数组的切片（除了array数组第一个元素以外的全部元素）。

例子

_.tail([1, 2, 3]);
// => [2, 3]

_.take(array, [n=1])

Ⓢ Ⓝ

创建一个数组切片，从array数组的起始元素开始提取n个元素。

添加版本

0.1.0

参数

1. array (Array): 要检索的数组。
2. [n=1] (number): 要提取的元素个数。

返回

(Array): 返回 array 数组的切片（从起始元素开始n个元素）。

例子

_.take([1, 2, 3]);
// => [1]
 
_.take([1, 2, 3], 2);
// => [1, 2]
 
_.take([1, 2, 3], 5);
// => [1, 2, 3]
 
_.take([1, 2, 3], 0);
// => []

_.takeRight(array, [n=1])

Ⓢ Ⓝ

创建一个数组切片，从array数组的最后一个元素开始提取n个元素。

添加版本

3.0.0

参数

1. array (Array): 要检索的数组。
2. [n=1] (number): 要提取的元素个数。

返回

(Array): 返回 array 数组的切片（从结尾元素开始n个元素）。

例子

_.takeRight([1, 2, 3]);
// => [3]
 
_.takeRight([1, 2, 3], 2);
// => [2, 3]
 
_.takeRight([1, 2, 3], 5);
// => [1, 2, 3]
 
_.takeRight([1, 2, 3], 0);
// => []

_.takeRightWhile(array, [predicate=_.identity])

Ⓢ Ⓝ

从array数组的最后一个元素开始提取元素，直到 predicate 返回假值。predicate 会传入三个参数： (value, index, array)。

添加版本

3.0.0

参数

1. array (Array): 要检索的数组。
2. [predicate=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。

返回

(Array): 返回 array 数组的切片。

例子

var users = [
  { 'user': 'barney',  'active': true },
  { 'user': 'fred',    'active': false },
  { 'user': 'pebbles', 'active': false }
];
 
_.takeRightWhile(users, function(o) { return !o.active; });
// => objects for ['fred', 'pebbles']
 
// The `_.matches` iteratee shorthand.
_.takeRightWhile(users, { 'user': 'pebbles', 'active': false });
// => objects for ['pebbles']
 
// The `_.matchesProperty` iteratee shorthand.
_.takeRightWhile(users, ['active', false]);
// => objects for ['fred', 'pebbles']
 
// The `_.property` iteratee shorthand.
_.takeRightWhile(users, 'active');
// => []

_.takeWhile(array, [predicate=_.identity])

Ⓢ Ⓝ

从array数组的起始元素开始提取元素，，直到 predicate 返回假值。predicate 会传入三个参数： (value, index, array)。

添加版本

3.0.0

参数

1. array (Array): 需要处理的数组
2. [predicate=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。

返回

(Array): 返回 array 数组的切片。

例子

var users = [
  { 'user': 'barney',  'active': false },
  { 'user': 'fred',    'active': false},
  { 'user': 'pebbles', 'active': true }
];
 
_.takeWhile(users, function(o) { return !o.active; });
// => objects for ['barney', 'fred']
 
// The `_.matches` iteratee shorthand.
_.takeWhile(users, { 'user': 'barney', 'active': false });
// => objects for ['barney']
 
// The `_.matchesProperty` iteratee shorthand.
_.takeWhile(users, ['active', false]);
// => objects for ['barney', 'fred']
 
// The `_.property` iteratee shorthand.
_.takeWhile(users, 'active');
// => []

_.union([arrays])

Ⓢ Ⓝ

创建一个按顺序排列的唯一值的数组。所有给定数组的元素值使用 SameValueZero做等值比较。（愚人码头注： arrays（数组）的并集，按顺序返回，返回数组的元素是唯一的）

添加版本

0.1.0

参数

1. [arrays] (...Array): 要检查的数组。

返回

(Array): 返回一个新的联合数组。

例子

_.union([2], [1, 2]);
// => [2, 1]

_.unionBy([arrays], [iteratee=_.identity])

Ⓢ Ⓝ

这个方法类似 _.union ，除了它接受一个 iteratee （迭代函数），调用每一个数组（array）的每个元素以产生唯一性计算的标准。iteratee 会传入一个参数：(value)。

添加版本

4.0.0

参数

1. [arrays] (...Array): 要检查的数组。
2. [iteratee=_.identity] (Array|Function|Object|string): 迭代函数，调用每个元素。

返回

(Array): 返回一个新的联合数组。

例子

_.unionBy([2.1], [1.2, 2.3], Math.floor);
// => [2.1, 1.2]
 
// The `_.property` iteratee shorthand.
_.unionBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x');
// => [{ 'x': 1 }, { 'x': 2 }]

_.unionWith([arrays], [comparator])

Ⓢ Ⓝ

这个方法类似 _.union， 除了它接受一个 comparator 调用比较arrays数组的每一个元素。 comparator 调用时会传入2个参数： (arrVal, othVal)。

添加版本

4.0.0

参数

1. [arrays] (...Array): 要检查的数组。
2. [comparator] (Function): 比较函数，调用每个元素。

返回

(Array): 返回一个新的联合数组。

例子

var objects = [{ 'x': 1, 'y': 2 }, { 'x': 2, 'y': 1 }];
var others = [{ 'x': 1, 'y': 1 }, { 'x': 1, 'y': 2 }];
 
_.unionWith(objects, others, _.isEqual);
// => [{ 'x': 1, 'y': 2 }, { 'x': 2, 'y': 1 }, { 'x': 1, 'y': 1 }]

_.uniq(array)

Ⓢ Ⓝ

创建一个去重后的array数组副本。使用了 SameValueZero 做等值比较。只有第一次出现的元素才会被保留。

添加版本

0.1.0

参数

1. array (Array): 要检查的数组。

返回

(Array): 返回新的去重后的数组。

例子

_.uniq([2, 1, 2]);
// => [2, 1]

_.uniqBy(array, [iteratee=_.identity])

Ⓢ Ⓝ

这个方法类似 _.uniq ，除了它接受一个 iteratee （迭代函数），调用每一个数组（array）的每个元素以产生唯一性计算的标准。iteratee 调用时会传入一个参数：(value)。

添加版本

4.0.0

参数

1. array (Array): 要检查的数组。
2. [iteratee=_.identity] (Array|Function|Object|string): 迭代函数，调用每个元素。

返回

(Array): 返回新的去重后的数组。

例子

_.uniqBy([2.1, 1.2, 2.3], Math.floor);
// => [2.1, 1.2]
 
// The `_.property` iteratee shorthand.
_.uniqBy([{ 'x': 1 }, { 'x': 2 }, { 'x': 1 }], 'x');
// => [{ 'x': 1 }, { 'x': 2 }]

_.uniqWith(array, [comparator])

Ⓢ Ⓝ

这个方法类似 _.uniq， 除了它接受一个 comparator 调用比较arrays数组的每一个元素。 comparator 调用时会传入2个参数： (arrVal, othVal)。

添加版本

4.0.0

参数

1. array (Array): 要检查的数组。
2. [comparator] (Function): 比较函数，调用每个元素。

返回

(Array): 返回新的去重后的数组。

例子

var objects = [{ 'x': 1, 'y': 2 }, { 'x': 2, 'y': 1 }, { 'x': 1, 'y': 2 }];
 
_.uniqWith(objects, _.isEqual);
// => [{ 'x': 1, 'y': 2 }, { 'x': 2, 'y': 1 }]

_.unzip(array)

Ⓢ Ⓝ

这个方法类似于 _.zip，除了它接收分组元素的数组，并且创建一个数组，分组元素到打包前的结构。（愚人码头：返回数组的第一个元素包含所有的输入数组的第一元素，第一个元素包含了所有的输入数组的第二元素，依此类推。）

添加版本

1.2.0

参数

1. array (Array): 要处理的分组元素数组。

返回

(Array): 返回重组元素的新数组。

例子

var zipped = _.zip(['fred', 'barney'], [30, 40], [true, false]);
// => [['fred', 30, true], ['barney', 40, false]]
 
_.unzip(zipped);
// => [['fred', 'barney'], [30, 40], [true, false]]

_.unzipWith(array, [iteratee=_.identity])

Ⓢ Ⓝ

此方法类似于 _.unzip，除了它接受一个iteratee指定重组值应该如何被组合。iteratee 调用时会传入每个分组的值： (...group)。

添加版本

3.8.0

参数

1. array (Array): 要处理的分组元素数组。
2. [iteratee=_.identity] (Function): 这个函数用来组合重组的值。

返回

(Array): 返回重组元素的新数组。

例子

var zipped = _.zip([1, 2], [10, 20], [100, 200]);
// => [[1, 10, 100], [2, 20, 200]]
 
_.unzipWith(zipped, _.add);
// => [3, 30, 300]

_.without(array, [values])

Ⓢ Ⓝ

创建一个剔除所有给定值的新数组，剔除值的时候，使用 SameValueZero做相等比较。

注意: 不像 _.pull, 这个方法会返回一个新数组。

添加版本

0.1.0

参数

1. array (Array): 要检查的数组。
2. [values] (...*): 要剔除的值。

返回

(Array): 返回过滤值后的新数组。

例子

_.without([2, 1, 2, 3], 1, 2);
// => [3]

_.xor([arrays])

Ⓢ Ⓝ

创建一个给定数组唯一值的数组，使用 symmetric difference做等值比较。返回值的顺序取决于他们数组的出现顺序。

添加版本

2.4.0

参数

1. [arrays] (...Array): 要检查的数组。

返回

(Array): 返回过滤值后的新数组。

例子

_.xor([2, 1], [2, 3]);
// => [1, 3]

_.xorBy([arrays], [iteratee=_.identity])

Ⓢ Ⓝ

这个方法类似 _.xor ，除了它接受 iteratee（迭代器），这个迭代器 调用每一个 arrays（数组）的每一个值，以生成比较的新值。iteratee 调用一个参数： (value).

添加版本

4.0.0

参数

1. [arrays] (...Array): 要检查的数组。
2. [iteratee=_.identity] (Array|Function|Object|string): 调用每一个元素的迭代函数。

返回

(Array): 返回过滤值后的新数组。

例子

_.xorBy([2.1, 1.2], [2.3, 3.4], Math.floor);
// => [1.2, 3.4]
 
// The `_.property` iteratee shorthand.
_.xorBy([{ 'x': 1 }], [{ 'x': 2 }, { 'x': 1 }], 'x');
// => [{ 'x': 2 }]

_.xorWith([arrays], [comparator])

Ⓢ Ⓝ

该方法是像 _.xor，除了它接受一个 comparator ，以调用比较数组的元素。 comparator 调用2个参数：(arrVal, othVal).

添加版本

4.0.0

参数

1. [arrays] (...Array): 要检查的数组。
2. [comparator] (Function): 调用每一个元素的比较函数。

返回

(Array): 返回过滤值后的新数组。

例子

var objects = [{ 'x': 1, 'y': 2 }, { 'x': 2, 'y': 1 }];
var others = [{ 'x': 1, 'y': 1 }, { 'x': 1, 'y': 2 }];
 
_.xorWith(objects, others, _.isEqual);
// => [{ 'x': 2, 'y': 1 }, { 'x': 1, 'y': 1 }]

_.zip([arrays])

Ⓢ Ⓝ

创建一个分组元素的数组，数组的第一个元素包含所有给定数组的第一个元素，数组的第二个元素包含所有给定数组的第二个元素，以此类推。

添加版本

0.1.0

参数

1. [arrays] (...Array): 要处理的数组。

返回

(Array): 返回分组元素的新数组。

例子

_.zip(['fred', 'barney'], [30, 40], [true, false]);
// => [['fred', 30, true], ['barney', 40, false]]

_.zipObject([props=[]], [values=[]])

Ⓢ Ⓝ

这个方法类似 _.fromPairs，除了它接受2个数组，第一个数组中的值作为属性标识符（属性名），第二个数组中的值作为相应的属性值。

添加版本

0.4.0

参数

1. [props=[]] (Array): The property identifiers.
2. [values=[]] (Array): The property values.

返回

(Object): Returns the new object.

例子

_.zipObject(['a', 'b'], [1, 2]);
// => { 'a': 1, 'b': 2 }

_.zipObjectDeep([props=[]], [values=[]])

Ⓢ Ⓝ

这个方法类似 _.zipObject，除了它支持属性路径。

添加版本

4.1.0

参数

1. [props=[]] (Array): 属性标识符（属性名）。
2. [values=[]] (Array): 属性值。

返回

(Object): 返回新对象。

例子

_.zipObjectDeep(['a.b[0].c', 'a.b[1].d'], [1, 2]);
// => { 'a': { 'b': [{ 'c': 1 }, { 'd': 2 }] } }

_.zipWith([arrays], [iteratee=_.identity])

Ⓢ Ⓝ

这个方法类似于 _.zip，不同之处在于它接受一个 iteratee（迭代函数），来 指定分组的值应该如何被组合。 该iteratee调用每个组的元素： (...group).

添加版本

3.8.0

参数

1. [arrays] (...Array): 要处理的数组。
2. [iteratee=_.identity] (Function): 函数用来组合分组的值。

返回

(Array): 返回分组元素的新数组。

例子

_.zipWith([1, 2], [10, 20], [100, 200], function(a, b, c) {
  return a + b + c;
});
// => [111, 222]

_.countBy(collection, [iteratee=_.identity])

Ⓢ Ⓝ

创建一个组成对象，key（键）是经过 iteratee（迭代函数） 执行处理collection中每个元素后返回的结果，每个key（键）对应的值是 iteratee（迭代函数）返回该key（键）的次数（愚人码头注：迭代次数）。 iteratee 调用一个参数：(value)。

添加版本

0.5.0

参数

1. collection (Array|Object): 一个用来迭代的集合。
2. [iteratee=_.identity] (Array|Function|Object|string): 一个迭代函数，用来转换key（键）。

返回

(Object): 返回一个组成集合对象。

例子

_.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])

Ⓢ Ⓝ

通过 predicate（断言函数） 检查 collection（集合）中的 所有 元素是否都返回真值。一旦 predicate（断言函数） 返回假值，迭代就马上停止。predicate（断言函数）调用三个参数： (value, index|key, collection)。

注意: 这个方法对于对于 空集合返回 true，因为空集合的 任何元素都是 true 。

添加版本

0.1.0

参数

1. collection (Array|Object): 一个用来迭代的集合。
2. [predicate=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。

返回

(boolean): 如果所有元素经 predicate（断言函数） 检查后都都返回真值，那么就返回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])

Ⓢ Ⓝ

遍历 collection（集合）元素，返回 predicate（断言函数）返回真值 的所有元素的数组。 predicate（断言函数）调用三个参数：(value, index|key, collection)。

Note: Unlike _.remove, this method returns a new array.

添加版本

0.1.0

参数

1. collection (Array|Object): 一个用来迭代的集合。
2. [predicate=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。

返回

(Array): 返回一个新的过滤后的数组。

例子

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])

Ⓢ Ⓝ

遍历 collection（集合）元素，返回 predicate（断言函数）第一个返回真值的第一个元素。predicate（断言函数）调用3个参数： (value, index|key, collection)。

添加版本

0.1.0

参数

1. collection (Array|Object): 一个用来迭代的集合。
2. [predicate=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。
3. [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])

Ⓢ Ⓝ

这个方法类似 _.find ，不同之处在于， _.findLast是从右至左遍历collection （集合）元素的。

添加版本

2.0.0

参数

1. collection (Array|Object): 一个用来迭代的集合。
2. [predicate=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。
3. [fromIndex=collection.length-1] (number): 开始搜索的索引位置。

返回

(*): 返回匹配元素，否则返回 undefined。

例子

_.findLast([1, 2, 3, 4], function(n) {
  return n % 2 == 1;
});
// => 3

_.flatMap(collection, [iteratee=_.identity])

Ⓢ Ⓝ

创建一个扁平化（愚人码头注：同阶数组）的数组，这个数组的值来自collection（集合）中的每一个值经过 iteratee（迭代函数） 处理后返回的结果，并且扁平化合并。 iteratee 调用三个参数： (value, index|key, collection)。

添加版本

4.0.0

参数

1. collection (Array|Object): 一个用来迭代遍历的集合。
2. [iteratee=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。

返回

(Array): 返回新扁平化数组。

例子

function duplicate(n) {
  return [n, n];
}
 
_.flatMap([1, 2], duplicate);
// => [1, 1, 2, 2]

_.flatMapDeep(collection, [iteratee=_.identity])

Ⓢ Ⓝ

这个方法类似 _.flatMap 不同之处在于， _.flatMapDeep 会继续扁平化递归映射的结果。

添加版本

4.7.0

参数

1. collection (Array|Object): 一个用来迭代的集合。
2. [iteratee=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。

返回

(Array): 返回新扁平化数组。

例子

function duplicate(n) {
  return [[[n, n]]];
}
 
_.flatMapDeep([1, 2], duplicate);
// => [1, 1, 2, 2]

_.flatMapDepth(collection, [iteratee=_.identity], [depth=1])

Ⓢ Ⓝ

该方法类似 _.flatMap，不同之处在于， _.flatMapDepth 会根据指定的 depth（递归深度）继续扁平化递归映射结果。

添加版本

4.7.0

参数

1. collection (Array|Object): 一个用来迭代的集合。
2. [iteratee=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。
3. [depth=1] (number): 最大递归深度。

返回

(Array): 返回新扁平化数组。

例子

function duplicate(n) {
  return [[[n, n]]];
}
 
_.flatMapDepth([1, 2], duplicate, 2);
// => [[1, 1], [2, 2]]

_.forEach(collection, [iteratee=_.identity])

Ⓢ Ⓝ

调用 iteratee 遍历 collection(集合) 中的每个元素， iteratee 调用3个参数： (value, index|key, collection)。 如果迭代函数（iteratee）显式的返回 false ，迭代会提前退出。

注意: 与其他"集合"方法一样，类似于数组，对象的 "length" 属性也会被遍历。想避免这种情况，可以用 _.forIn 或者 _.forOwn 代替。

添加版本

0.1.0

别名

_.each

参数

1. collection (Array|Object): 一个用来迭代的集合。
2. [iteratee=_.identity] (Function): 每次迭代调用的函数。

返回

(*): 返回集合 collection。

例子

_([1, 2]).forEach(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])

Ⓢ Ⓝ

这个方法类似 _.forEach，不同之处在于， _.forEachRight 是从右到左遍历集合中每一个元素的。

添加版本

2.0.0

别名

_.eachRight

参数

1. collection (Array|Object): 一个用来迭代的集合。
2. [iteratee=_.identity] (Function): 每次迭代调用的函数。

返回

(*): 返回集合 collection。

例子

_.forEachRight([1, 2], function(value) {
  console.log(value);
});
// => Logs `2` then `1`.

_.groupBy(collection, [iteratee=_.identity])

Ⓢ Ⓝ

创建一个对象，key 是 iteratee 遍历 collection(集合) 中的每个元素返回的结果。 分组值的顺序是由他们出现在 collection(集合) 中的顺序确定的。每个键对应的值负责生成 key 的元素组成的数组。iteratee 调用 1 个参数： (value)。

添加版本

0.1.0

参数

1. collection (Array|Object): 一个用来迭代的集合。
2. [iteratee=_.identity] (Array|Function|Object|string): 这个迭代函数用来转换key。

返回

(Object): 返回一个组成聚合的对象。

例子

_.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])

Ⓢ Ⓝ

检查 value(值) 是否在 collection(集合) 中。如果 collection(集合)是一个字符串，那么检查 value（值，子字符串） 是否在字符串中， 否则使用 SameValueZero 做等值比较。 如果指定 fromIndex 是负数，那么从 collection(集合) 的结尾开始检索。

添加版本

0.1.0

参数

1. collection (Array|Object|string): 要检索的集合。
2. value (*): 要检索的值。
3. [fromIndex=0] (number): 要检索的 索引位置。

返回

(boolean): 如果找到 value 返回 true， 否则返回 false。

例子

_.includes([1, 2, 3], 1);
// => true
 
_.includes([1, 2, 3], 1, 2);
// => false
 
_.includes({ 'user': 'fred', 'age': 40 }, 'fred');
// => true
 
_.includes('pebbles', 'eb');
// => true

_.invokeMap(collection, path, [args])

Ⓢ Ⓝ

调用path（路径）上的方法处理 collection(集合)中的每个元素，返回一个数组，包含每次调用方法得到的结果。任何附加的参数提供给每个被调用的方法。如果methodName（方法名）是一个函数，每次调用函数时，内部的 this 指向集合中的每个元素。

添加版本

4.0.0

参数

1. collection (Array|Object): 用来迭代的集合。
2. path (Array|Function|string): 用来调用方法的路径 或 者每次迭代调用的函数。
3. [args] (...*): 调用每个方法的参数。

返回

(Array): 返回的结果数组。

例子

_.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])

Ⓢ Ⓝ

创建一个对象组成， key（键） 是 collection（集合）中的每个元素经过 iteratee（迭代函数） 处理后返回的结果。 每个 key（键）对应的值是生成key（键）的最后一个元素。iteratee（迭代函数）调用1个参数：(value)。

添加版本

4.0.0

参数

1. collection (Array|Object): 用来迭代的集合。
2. [iteratee=_.identity] (Array|Function|Object|string): 这个迭代函数用来转换key。

返回

(Object): 返回一个组成聚合的对象。

例子

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])

Ⓢ Ⓝ

创建一个数组， value（值） 是 iteratee（迭代函数）遍历 collection（集合）中的每个元素后返回的结果。 iteratee（迭代函数）调用3个参数：
(value, index|key, collection).

lodash 中有许多方法是防止作为其他方法的迭代函数（愚人码头注：即不能作为iteratee参数传递给其他方法），例如： _.every, _.filter, _.map, _.mapValues, _.reject, 和 _.some。

受保护的方法有（愚人码头注：即这些方法不能使用 _.every, _.filter, _.map, _.mapValues, _.reject, 和 _.some作为 iteratee 迭代函数参数） ：
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

参数

1. collection (Array|Object): 用来迭代的集合。
2. [iteratee=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。

返回

(Array): 返回新的映射后数组。

例子

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，除了它允许指定 iteratee（迭代函数）结果如何排序。 如果没指定 orders（排序），所有值以升序排序。 否则，指定为"desc" 降序，或者指定为 "asc" 升序，排序对应值。

添加版本

4.0.0

参数

1. collection (Array|Object): 用来迭代的集合。
2. [iteratees=[_.identity]] (Array[]|Function[]|Object[]|string[]): 排序的迭代函数。
3. [orders] (string[]): iteratees迭代函数的排序顺序。

返回

(Array): 排序排序后的新数组。

例子

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]]

_.partition(collection, [predicate=_.identity])

Ⓢ Ⓝ

创建一个分成两组的元素数组，第一组包含predicate（断言函数）返回为 truthy（真值）的元素，第二组包含predicate（断言函数）返回为 falsey（假值）的元素。predicate 调用1个参数：(value)。

添加版本

3.0.0

参数

1. collection (Array|Object): 用来迭代的集合。
2. [predicate=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。

返回

(Array): 返回元素分组后的数组。

例子

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])

Ⓢ Ⓝ

压缩 collection（集合）为一个值，通过 iteratee（迭代函数）遍历 collection（集合）中的每个元素，每次返回的值会作为下一次迭代使用(愚人码头注：作为iteratee（迭代函数）的第一个参数使用)。 如果没有提供 accumulator，则 collection（集合）中的第一个元素作为初始值。(愚人码头注：accumulator参数在第一次迭代的时候作为iteratee（迭代函数）第一个参数使用。) iteratee 调用4个参数：
(accumulator, value, index|key, collection).

lodash 中有许多方法是防止作为其他方法的迭代函数（愚人码头注：即不能作为iteratee参数传递给其他方法），例如： _.reduce, _.reduceRight, 和 _.transform。

受保护的方法有（愚人码头注：即这些方法不能使用 _.reduce, _.reduceRight, 和 _.transform作为 iteratee 迭代函数参数）：

assign, defaults, defaultsDeep, includes, merge, orderBy, 和 sortBy

添加版本

0.1.0

参数

1. collection (Array|Object): 用来迭代的集合。
2. [iteratee=_.identity] (Function): 每次迭代调用的函数。
3. [accumulator] (*): 初始值。

返回

(*): 返回累加后的值。

例子

_.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'] } (无法保证遍历的顺序)

_.reduceRight(collection, [iteratee=_.identity], [accumulator])

Ⓢ Ⓝ

这个方法类似 _.reduce ，除了它是从右到左遍历collection（集合）中的元素的。

添加版本

0.1.0

参数

1. collection (Array|Object): 用来迭代的集合。
2. [iteratee=_.identity] (Function): 每次迭代调用的函数。
3. [accumulator] (*): 初始值。

返回

(*): 返回累加后的值。

例子

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的反向方法;此方法 返回 predicate（断言函数） 不 返回 truthy（真值）的collection（集合）元素（愚人码头注释：非真）。

添加版本

0.1.0

参数

1. collection (Array|Object): 用来迭代的集合。
2. [predicate=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。

返回

(Array): 返回过滤后的新数组

例子

var users = [
  { 'user': 'barney', 'age': 36, 'active': false },
  { 'user': 'fred',   'age': 40, 'active': true }
];
 
_.reject(users, function(o) { return !o.active; });
// => objects for ['fred']
 
// `_.matches` 迭代简写
_.reject(users, { 'age': 40, 'active': true });
// => objects for ['barney']
 
// `_.matchesProperty` 迭代简写
_.reject(users, ['active', false]);
// => objects for ['fred']
 
// `_.property` 迭代简写
_.reject(users, 'active');
// => objects for ['barney']

_.sample(collection)

Ⓢ Ⓝ

从collection（集合）中获得一个随机元素。

添加版本

2.0.0

参数

1. collection (Array|Object): 要取样的集合。

返回

(*): 返回随机元素。

例子

_.sample([1, 2, 3, 4]);
// => 2

_.sampleSize(collection, [n=1])

Ⓢ Ⓝ

从collection（集合）中获得 n 个随机元素。

添加版本

4.0.0

参数

1. collection (Array|Object): 要取样的集合。
2. [n=1] (number): 取样的元素个数。

返回

(Array): 返回随机元素。

例子

_.sampleSize([1, 2, 3], 2);
// => [3, 1]
 
_.sampleSize([1, 2, 3], 4);
// => [2, 3, 1]

_.shuffle(collection)

Ⓢ Ⓝ

创建一个被打乱值的集合。 使用 Fisher-Yates shuffle 版本。

添加版本

0.1.0

参数

1. collection (Array|Object): 要打乱的集合。

返回

(Array): 返回打乱的新数组。

例子

_.shuffle([1, 2, 3, 4]);
// => [4, 1, 3, 2]

_.size(collection)

Ⓢ Ⓝ

返回collection（集合）的长度，如果集合是类数组或字符串，返回其 length ；如果集合是对象，返回其可枚举属性的个数。

添加版本

0.1.0

参数

1. collection (Array|Object): 要检查的集合

返回

(number): 返回集合的长度。

例子

_.size([1, 2, 3]);
// => 3
 
_.size({ 'a': 1, 'b': 2 });
// => 2
 
_.size('pebbles');
// => 7

_.some(collection, [predicate=_.identity])

Ⓢ Ⓝ

通过 predicate（断言函数） 检查collection（集合）中的元素是否存在 任意 truthy（真值）的元素，一旦 predicate（断言函数） 返回 truthy（真值），遍历就停止。 predicate 调用3个参数：(value, index|key, collection)。

添加版本

0.1.0

参数

1. collection (Array|Object): 用来迭代的集合。
2. [predicate=_.identity] (Array|Function|Object|string): 每次迭代调用的函数。

返回

(boolean): 如果任意元素经 predicate 检查都为 truthy（真值），返回 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]])

Ⓢ Ⓝ

创建一个元素数组。 以 iteratee 处理的结果升序排序。 这个方法执行稳定排序，也就是说相同元素会保持原始排序。 iteratees 调用1个参数： (value)。

添加版本

0.1.0

参数

1. collection (Array|Object): 用来迭代的集合。
2. [iteratees=[_.identity]] (...(Array|Array[]|Function|Function[]|Object|Object[]|string|string[])): 这个函数决定排序。

返回

(Array): 返回排序后的数组。

例子

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]]
 
_.sortBy(users, 'user', function(o) {
  return Math.floor(o.age / 10);
});
// => objects for [['barney', 36], ['barney', 34], ['fred', 48], ['fred', 40]]

_.now()

Ⓢ Ⓝ

获得 Unix 纪元 (1 January 1970 00:00:00 UTC) 直到现在的毫秒数。

添加版本

2.4.0

返回

(number): 返回时间戳。

例子

_.defer(function(stamp) {
  console.log(_.now() - stamp);
}, _.now());
// => 记录延迟函数调用的毫秒数

_.after(n, func)

Ⓢ Ⓝ

_.before的反向函数;此方法创建一个函数，当他被调用n或更多次之后将马上触发func 。

添加版本

0.1.0

参数

1. n (number): func 方法应该在调用多少次后才执行。
2. func (Function): 用来限定的函数。

返回

(Function): 返回新的限定函数。

例子

var saves = ['profile', 'settings'];
 
var done = _.after(saves.length, function() {
  console.log('done saving!');
});
 
_.forEach(saves, function(type) {
  asyncSave({ 'type': type, 'complete': done });
});
// => Logs 'done saving!' after the two async saves have completed.

_.ary(func, [n=func.length])

Ⓢ Ⓝ

创建一个调用func的函数。调用func时最多接受 n个参数，忽略多出的参数。

添加版本

3.0.0

参数

1. func (Function): 需要被限制参数个数的函数。
2. [n=func.length] (number): 限制的参数数量。

返回

(Function): 返回新的覆盖函数。

例子

_.map(['6', '8', '10'], _.ary(parseInt, 1));
// => [6, 8, 10]

_.before(n, func)

Ⓢ Ⓝ

创建一个调用func的函数，通过this绑定和创建函数的参数调用func，调用次数不超过 n 次。 之后再调用这个函数，将返回一次最后调用func的结果。

添加版本

3.0.0

参数

1. n (number): 超过多少次不再调用func（愚人码头注：限制调用func 的次数）。
2. func (Function): 限制执行的函数。

返回

(Function): 返回新的限定函数。

例子

jQuery(element).on('click', _.before(5, addContactToList));
// => allows adding up to 4 contacts to the list

_.bind(func, thisArg, [partials])

Ⓢ Ⓝ

创建一个调用func的函数，thisArg绑定func函数中的 this (愚人码头注：this的上下文为thisArg) ，并且func函数会接收partials附加参数。

_.bind.placeholder值，默认是以 _ 作为附加部分参数的占位符。

注意: 不同于原生的 Function#bind，这个方法不会设置绑定函数的 "length" 属性。

添加版本

0.1.0

参数

1. func (Function): 绑定的函数。
2. thisArg (*): func 绑定的this对象。
3. [partials] (...*): 附加的部分参数。

返回

(Function): 返回新的绑定函数。

例子

var greet = function(greeting, punctuation) {
  return greeting + ' ' + this.user + punctuation;
};
 
var object = { 'user': 'fred' };
 
var bound = _.bind(greet, object, 'hi');
bound('!');
// => 'hi fred!'
 
// Bound with placeholders.
var bound = _.bind(greet, object, _, '!');
bound('hi');
// => 'hi fred!'

_.bindKey(object, key, [partials])

Ⓢ Ⓝ

创建一个函数,在object[key]上通过接收partials附加参数，调用这个方法。

这个方法与 _.bind 的不同之处在于允许重新定义绑定函数即使它还不存在。 浏览 Peter Michaux's article 了解更多详情。

_.bind.placeholder值，默认是以 _ 作为附加部分参数的占位符。

添加版本

0.10.0

参数

1. object (Object): 需要绑定函数的对象。
2. key (string): 需要绑定函数对象的键。
3. [partials] (...*): 附加的部分参数。

返回

(Function): 返回新的绑定函数。

例子

var object = {
  'user': 'fred',
  'greet': function(greeting, punctuation) {
    return greeting + ' ' + this.user + punctuation;
  }
};
 
var bound = _.bindKey(object, 'greet', 'hi');
bound('!');
// => 'hi fred!'
 
object.greet = function(greeting, punctuation) {
  return greeting + 'ya ' + this.user + punctuation;
};
 
bound('!');
// => 'hiya fred!'
 
// Bound with placeholders.
var bound = _.bindKey(object, 'greet', _, '!');
bound('hi');
// => 'hiya fred!'

_.curry(func, [arity=func.length])

Ⓢ Ⓝ

创建一个函数，该函数接收 func 的参数，要么调用func返回的结果，如果 func 所需参数已经提供，则直接返回 func 所执行的结果。或返回一个函数，接受余下的func 参数的函数，可以使用 func.length 强制需要累积的参数个数。

_.curry.placeholder值，默认是以 _ 作为附加部分参数的占位符。

Note: 这个方法不会设置 curried 函数的 "length" 属性。

添加版本

2.0.0

参数

1. func (Function): 用来柯里化（curry）的函数。
2. [arity=func.length] (number): 需要提供给 func 的参数数量。

返回

(Function): 返回新的柯里化（curry）函数。

例子

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]

_.curryRight(func, [arity=func.length])

Ⓢ Ⓝ

这个方法类似 _.curry。 除了它接受参数的方式用 _.partialRight 代替了 _.partial。

_.curryRight.placeholder值，默认是以 _ 作为附加部分参数的占位符。

Note: 这个方法不会设置 curried 函数的 "length" 属性。

添加版本

3.0.0

参数

1. func (Function): 用来柯里化（curry）的函数。
2. [arity=func.length] (number): 需要提供给 func 的参数数量。

返回

(Function): 返回新的柯里化（curry）函数。

例子

var abc = function(a, b, c) {
  return [a, b, c];
};
 
var curried = _.curryRight(abc);
 
curried(3)(2)(1);
// => [1, 2, 3]
 
curried(2, 3)(1);
// => [1, 2, 3]
 
curried(1, 2, 3);
// => [1, 2, 3]
 
// Curried with placeholders.
curried(3)(1, _)(2);
// => [1, 2, 3]

_.debounce(func, [wait=0], [options={}])

Ⓢ Ⓝ

创建一个 debounced（防抖动）函数，该函数会从上一次被调用后，延迟 wait 毫秒后调用 func 方法。 debounced（防抖动）函数提供一个 cancel 方法取消延迟的函数调用以及 flush 方法立即调用。 可以提供一个 options（选项） 对象决定如何调用 func 方法，options.leading 与|或 options.trailing 决定延迟前后如何触发（愚人码头注：是 先调用后等待 还是 先等待后调用）。 func 调用时会传入最后一次提供给 debounced（防抖动）函数 的参数。 后续调用的 debounced（防抖动）函数返回是最后一次 func 调用的结果。

注意: 如果 leading 和 trailing 选项为 true, 则 func 允许 trailing 方式调用的条件为: 在 wait 期间多次调用防抖方法。

如果 wait 为 0 并且 leading 为 false, func调用将被推迟到下一个点，类似setTimeout为0的超时。

See David Corbacho's article for details over the differences between _.debounce and _.throttle.

添加版本

0.1.0

参数

1. func (Function): 要防抖动的函数。
2. [wait=0] (number): 需要延迟的毫秒数。
3. [options={}] (Object): 选项对象。
4. [options.leading=false] (boolean): 指定在延迟开始前调用。
5. [options.maxWait] (number): 设置 func 允许被延迟的最大值。
6. [options.trailing=true] (boolean): 指定在延迟结束后调用。

返回

(Function): 返回新的 debounced（防抖动）函数。

例子

// 避免窗口在变动时出现昂贵的计算开销。
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);

_.defer(func, [args])

Ⓢ Ⓝ

推迟调用func，直到当前堆栈清理完毕。 调用时，任何附加的参数会传给func。

添加版本

0.1.0

参数

1. func (Function): 要延迟的函数。
2. [args] (...*): 会在调用时传给 func 的参数。

返回

(number):返回计时器 id。

例子

_.defer(function(text) {
  console.log(text);
}, 'deferred');
// => 一毫秒或更久一些输出 'deferred'。

_.delay(func, wait, [args])

Ⓢ Ⓝ

延迟 wait 毫秒后调用 func。 调用时，任何附加的参数会传给func。

添加版本

0.1.0

参数

1. func (Function): 要延迟的函数。
2. wait (number): 要延迟的毫秒数。
3. [args] (...*): 会在调用时传入到 func 的参数。

返回

(number): 返回计时器 id

例子

_.delay(function(text) {
  console.log(text);
}, 1000, 'later');
// => 一秒后输出 'later'。

_.flip(func)

Ⓢ Ⓝ

创建一个函数，调用func时候接收翻转的参数。

添加版本

4.0.0

参数

1. func (Function): 要翻转参数的函数。

返回

(Function): 返回新的函数。

例子

var flipped = _.flip(function() {
  return _.toArray(arguments);
});
 
flipped('a', 'b', 'c', 'd');
// => ['d', 'c', 'b', 'a']

_.memoize(func, [resolver])

Ⓢ Ⓝ

创建一个会缓存 func 结果的函数。 如果提供了 resolver ，就用 resolver 的返回值作为 key 缓存函数的结果。 默认情况下用第一个参数作为缓存的 key。 func 在调用时 this 会绑定在缓存函数上。

注意: 缓存会暴露在缓存函数的 cache 上。 它是可以定制的，只要替换了 _.memoize.Cache 构造函数，或实现了 Map 的 delete, get, has, 和 set方法。

添加版本

0.1.0

参数

1. func (Function): 需要缓存化的函数.
2. [resolver] (Function): 这个函数的返回值作为缓存的 key。

返回

(Function): 返回缓存化后的函数。

例子

var object = { 'a': 1, 'b': 2 };
var other = { 'c': 3, 'd': 4 };
 
var values = _.memoize(_.values);
values(object);
// => [1, 2]
 
values(other);
// => [3, 4]
 
object.a = 2;
values(object);
// => [1, 2]
 
// 修改结果缓存。
values.cache.set(object, ['a', 'b']);
values(object);
// => ['a', 'b']
 
// 替换 `_.memoize.Cache`。
_.memoize.Cache = WeakMap;

_.negate(predicate)

Ⓢ Ⓝ

创建一个针对断言函数 func 结果取反的函数。 func 断言函数被调用的时候，this 绑定到创建的函数，并传入对应参数。

添加版本

3.0.0

参数

1. predicate (Function): 需要对结果取反的函数。

返回

(Function): 返回一个新的取反函数。

例子

function isEven(n) {
  return n % 2 == 0;
}
 
_.filter([1, 2, 3, 4, 5, 6], _.negate(isEven));
// => [1, 3, 5]

_.once(func)

Ⓢ Ⓝ

创建一个只能调用 func 一次的函数。 重复调用返回第一次调用的结果。 func 调用时， this 绑定到创建的函数，并传入对应参数。

添加版本

0.1.0

参数

1. func (Function): 指定的触发的函数。

返回

(Function): 返回新的受限函数。

例子

var initialize = _.once(createApplication);
initialize();
initialize();
// `initialize` 只能调用 `createApplication` 一次。

_.overArgs(func, [transforms=[_.identity]])

Ⓢ Ⓝ

创建一个函数，调用func时参数为相对应的transforms的返回值。

添加版本

4.0.0

参数

1. func (Function):要包裹的函数。

返回

(Function): 返回新函数。

例子

function doubled(n) {
  return n * 2;
}
 
function square(n) {
  return n * n;
}
 
var func = _.overArgs(function(x, y) {
  return [x, y];
}, [square, doubled]);
 
func(9, 3);
// => [81, 6]
 
func(10, 5);
// => [100, 10]

_.partial(func, [partials])

Ⓢ Ⓝ

创建一个函数。 该函数调用 func，并传入预设的 partials 参数。 这个方法类似 _.bind，除了它不会绑定 this。

这个 _.partial.placeholder 的值，默认是以 _ 作为附加部分参数的占位符。

注意: 这个方法不会设置 "length" 到函数上。

添加版本

0.2.0

参数

1. func (Function): 需要预设的函数
2. [partials] (...*): 预设的参数

返回

(Function): 返回预设参数的函数。

例子

var greet = function(greeting, name) {
  return greeting + ' ' + name;
};
 
var sayHelloTo = _.partial(greet, 'hello');
sayHelloTo('fred');
// => 'hello fred'
 
// 使用了占位符。
var greetFred = _.partial(greet, _, 'fred');
greetFred('hi');
// => 'hi fred'

_.partialRight(func, [partials])

Ⓢ Ⓝ

这个函数类似 _.partial，除了预设参数被附加到接受参数的后面。

这个 _.partialRight.placeholder 的值，默认是以 _ 作为附加部分参数的占位符。

注意: 这个方法不会设置 "length" 到函数上。

添加版本

1.0.0

参数

1. func (Function): 需要预设的函数。
2. [partials] (...*): 预设的参数。

返回

(Function):返回预设参数的函数。

例子

var greet = function(greeting, name) {
  return greeting + ' ' + name;
};
 
var greetFred = _.partialRight(greet, 'fred');
greetFred('hi');
// => 'hi fred'
 
// 使用了占位符。
var sayHelloTo = _.partialRight(greet, 'hello', _);
sayHelloTo('fred');
// => 'hello fred'

_.rearg(func, indexes)

Ⓢ Ⓝ

创建一个函数,调用func时，根据指定的 indexes 调整对应位置参数。其中第一个索引值是对应第一个参数，第二个索引值是作为第二个参数，依此类推。

添加版本

3.0.0

参数

1. func (Function): 待调用的函数。
2. indexes (...(number|number[])): 排列参数的位置。

返回

(Function): 返回新的函数。

例子

var rearged = _.rearg(function(a, b, c) {
  return [a, b, c];
}, [2, 0, 1]);
 
rearged('b', 'c', 'a')
// => ['a', 'b', 'c']

_.rest(func, [start=func.length-1])

Ⓢ Ⓝ

创建一个函数，调用func时，this绑定到创建的新函数，并且start之后的参数作为数组传入。

Note: 这个方法基于 rest parameter。

添加版本

4.0.0

参数

1. func (Function): 要应用的函数。
2. [start=func.length-1] (number): rest 参数的开始位置。

返回

(Function): 返回新的函数。

例子

var say = _.rest(function(what, names) {
  return what + ' ' + _.initial(names).join(', ') +
    (_.size(names) > 1 ? ', & ' : '') + _.last(names);
});
 
say('hello', 'fred', 'barney', 'pebbles');
// => 'hello fred, barney, & pebbles'

_.spread(func, [start=0])

Ⓢ Ⓝ

创建一个函数，调用func时，this绑定到创建的新函数，把参数作为数组传入，类似于 Function#apply.

Note: 这个方法基于 spread operator.

添加版本

3.2.0

参数

1. func (Function): 要应用传播参数的函数。
2. [start=0] (number): spread 参数的开始位置.

返回

(Function): 返回新的函数。

例子

var say = _.spread(function(who, what) {
  return who + ' says ' + what;
});
 
say(['fred', 'hello']);
// => 'fred says hello'
 
var numbers = Promise.all([
  Promise.resolve(40),
  Promise.resolve(36)
]);
 
numbers.then(_.spread(function(x, y) {
  return x + y;
}));
// => a Promise of 76

_.throttle(func, [wait=0], [options={}])

Ⓢ Ⓝ

创建一个节流函数，在 wait 秒内最多执行 func 一次的函数。 该函数提供一个 cancel 方法取消延迟的函数调用以及 flush 方法立即调用。 可以提供一个 options 对象决定如何调用 func 方法， options.leading 与|或 options.trailing 决定 wait 前后如何触发。 func 会传入最后一次传入的参数给这个函数。 随后调用的函数返回是最后一次 func 调用的结果。

注意: 如果 leading 和 trailing 都设定为 true 则 func 允许 trailing 方式调用的条件为: 在 wait 期间多次调用。

如果 wait 为 0 并且 leading 为 false, func调用将被推迟到下一个点，类似setTimeout为0的超时。

查看 David Corbacho's article 了解 _.throttle 与 _.debounce 的区别。

添加版本

0.1.0

参数

1. func (Function): 要节流的函数。
2. [wait=0] (number): 需要节流的毫秒。
3. [options={}] (Object): 选项对象。
4. [options.leading=true] (boolean): 指定调用在节流开始前。
5. [options.trailing=true] (boolean): 指定调用在节流结束后。

返回

(Function): 返回节流的函数。

例子

// 避免在滚动时过分的更新定位
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);

_.unary(func)

Ⓢ Ⓝ

创建一个最多接受一个参数的函数，忽略多余的参数。

添加版本

4.0.0

参数

1. func (Function): 要处理的函数。

返回

(Function): 返回新函数。

例子

_.map(['6', '8', '10'], _.unary(parseInt));
// => [6, 8, 10]

_.wrap(value, [wrapper=identity])

Ⓢ Ⓝ

创建一个函数。提供的 value 包装在 wrapper 函数的第一个参数里。 任何附加的参数都提供给 wrapper 函数。 被调用时 this 绑定在创建的函数上。

添加版本

0.1.0

参数