It has been 1485 days since the last update, the content of the article may be outdated.

Installation

  • Node.js npm install underscore
  • Meteor.js meteor add underscore
  • Require.js require(["underscore"], ...
  • Bower bower install underscore
  • Component component install jashkenas/underscore

collections 工具

map/filter

和Array的map()与filter()类似,但是underscore的map()和filter()可以作用于Object。
当作用于Object时,传入的函数为function (value, key),第一个参数接收value,第二个参数接收key:

plaintext
var obj = {
name: 'bob',
school: 'No.1 middle school',
address: 'xueyuan road'
};

var upper = _.map(obj, (value, key)=>key+": "+value);
console.log(JSON.stringify(upper)); //["name: bob","school: No.1 middle school","address: xueyuan road"]

var upper = _.filter(obj, (value, key)=>key==='name');
console.log(JSON.stringify(upper)); //['bob']

_.mapObject 返回对象。

_.some _.every

当集合的所有元素都满足条件时,_.every()函数返回true,当集合的至少一个元素满足条件时,_.some()函数返回true:

plaintext
'use strict';
// 所有元素都大于0?
_.every([1, 4, 7, -3, -9], (x) => x > 0); // false
// 至少一个元素大于0?
_.some([1, 4, 7, -3, -9], (x) => x > 0); // true

当集合是Object时,我们可以同时获得value和key:

plaintext
'use strict';
var obj = {
name: 'bob',
school: 'No.1 middle school',
address: 'xueyuan road'
};

// 判断key和value是否全部是小写:
var r1 = .every(obj, function (value, key) {
return .every(value+key,(x)=>x>='a'&&x=<'z');
});
var r2 = .some(obj, function (value, key) {
return .some(value+key,(x)=>x>='a'&&x=<'z');
});

max / min

这两个函数直接返回集合中最大和最小的数:

plaintext
var arr = [3, 5, 7, 9];
_.max(arr); // 9
_.min(arr); // 3

_.max({ a: 1, b: 2, c: 3 }); // 3

如果集合是Object,max()和min()只作用于value,忽略掉key:

groupBy

groupBy()把集合的元素按照key归类,key由传入的函数返回:

plaintext
var scores = [20, 81, 75, 40, 91, 59, 77, 66, 72, 88, 99];
var groups = _.groupBy(scores, function (x) {
if (x < 60) {
return 'C';
} else if (x < 80) {
return 'B';
} else {
return 'A';
}
});
// 结果:
// {
// A: [81, 91, 88, 99],
// B: [75, 77, 66, 72],
// C: [20, 40, 59]
// }

shuffle / sample

shuffle()用洗牌算法随机打乱一个集合;
sample()则是随机选择一个或多个元素。

plaintext
_.shuffle([1, 2, 3, 4, 5, 6]); // [3, 5, 4, 6, 2, 1] 注意每次结果都不一样:

// 注意每次结果都不一样:
// 随机选1个:
_.sample([1, 2, 3, 4, 5, 6]); // 2
// 随机选3个:
_.sample([1, 2, 3, 4, 5, 6], 3); // [6, 1, 4]

more functions
github-underscore