Node-plus NPM | npm.io

#Plus.js

A mini javascript library for web developers, base on underscore.js.

Collection Methods

_.each(obj, func, context) ecmascript 5

对指定数组、对象的每个元素执行指定操作。

func接受3个参数: (val, idx, list)

var countIdx = 0,
	countValue = 0,
	countList;

_.each([1,2,3], function (val, idx, list) {
	countIdx += idx;
	countValue += val;
	countList = list;
});
=> countIdx:    3
=> countValue:  6
=> countList:   [1, 2, 3]

_.map(obj, func, context) ecmascript 5

对数组、对象的每个元素调用定义的回调函数并返回包含结果的数组。

func接受3个参数: (val, idx, list)

_.map([1, 3, 5], function (val, idx, list) {
	return val + 2;
});
=> [3, 5, 7]

_.pluck(obj, value)

获取obj中，值为value的所有元素，返回的是一个数组。

_.pluck([{
	age: 50,
	name: 'joe'
}, {
	age: 35,
	name: 'jason'
}, {
	age: 20,
	name: 'jacket'
}], 'age');
=> [50, 35, 20]

_.find(obj, predicate, context)

在给定obj中寻找第一个predicate为true的元素，如果未找到，则返回undefined。

predicate接受3个参数: (val, idx, list)

_.find([5, 4, 3, 2, -1, 0], function (val, idx, list) {
	return idx === 4;
});
=> -1

_.filter(obj, predicate, context) ecmascript 5

从obj中过滤出predicate为true的元素，与find不同的是，filter会查找所有符合要求元素，而不是查找到第一个之后就停止查找。返回一个数组。

predicate接受3个参数: (val, idx, list)

alias: _.grep

_.filter([1, -1, 3, 5], function (val, idx, list) {
	return val > 0;
});
=> [1, 3, 5]

_.reject(obj, predicate, context)

与_.filter相反，返回predicate为false的元素。

predicate接受3个参数: (val, idx, list)

_.reject([1, -1, 3, 5], function (val, idx, list) {
	return val > 0;
});
=> [-1]

_.where(obj, attrs)

从给定obj中过滤出所有符合attrs过滤条件的元素。

_.where([{
	age: 50,
	idx: 0,
	name: 'jason'
}, {
	age: 50,
	idx: 0,
	name: 'rocket'
}, {
	age: 50,
	idx: 1,
	name: 'tom'
}, {
	age: 40,
	idx: 0,
	name: 'test'
}], {
	age: 50,
	idx: 0
});  // 过滤 age === 50 && idx === 0的所有元素
=> [{
	age:50,
	idx: 0,
	name: 'jason'
}, {
	age: 50,
	idx: 0,
	name: 'rocket'
}]

_.findWhere(obj, attrs)

从给定obj中过滤出第一个符合attrs过滤条件的元素。

_.findWhere([{
	age: 10,
	name: 'jack'
}, {
	age: 18,
	name: 'tom'
}, {
	age: 18,
	name: 'jerry'
}], {
	age: 18
});
=> {
	age: 18,
	name: 'tom'
}

_.every(obj, predicate, context) ecmascript 5

确定数组、对象的所有元素是否满足指定的测试。

predicate接受3个参数：(val, idx, list)

_.every([1, 9 ,10, 20], function (val, idx, list) {
	return val > 0;
});
=> true

_.some(obj, predicate, context) ecmascript 5

给定obj中，只要有一个元素能让predicate返回为true，则返回true；否则为false。

predicate接受3个参数：(val, idx, list)

alias: _.any

_.some([1, 2, 4, -1], function (val, idx, list) {
	return val < 0;
});
=> true

_.contains(obj, target)

判断给定的target值是否在obj中。

（注意：该函数只用来处理数组、对象，不用作String.indexOf > -1的判断）

_.contains([1, 3, 5, 4, 9], 4);
=> true

_.size(obj)

返回数组、对象的元素个数。（不遍历对象原型）

_.size({
	a: 1,2,3
	b: 2,
	c: 3
});
=> 3

_.toArray(obj)

将argument对象、类数组、对象等转换为数组。

var argv;
(function (a, b) {
	argv = _.toArray(arguments);
})(1, 2);
=> argv: [1, 2]