【理解Underscore和LoDash】Collections _.each

_.each

遍历集合，对集合中的每个元素执行回调。

API

Lo-Dash

_.forEach(collection [, callback=identity, thisArg])

Aliases

each

Arguments

1. collection (Array|Object|String): 要遍历的集合
2. [callback=identity] (Function): 每次迭代中调用的函数
3. [thisArg] (任意): 绑定到callback的this
4. callback接受三个参数: (value, index|key, collection)

Returns

(Array, Object, String): 返回collection.

Underscore

_.each(list, iterator, [context])

Aliases

forEach

Arguments

1. list (Array|Object|String): 要遍历的集合
2. iterator (Function): 每次迭代中调用的函数
3. [context] (任意): 绑定到callback的this
4. iterator接受三个参数: (element|value, index|key, list)

Returns

(Array, Object, String): 返回undefined.

Note

• Lo-Dash可以省略回调函数，而Underscore则必须传入
• Lo-Dash可以通过在回调中返回false提前结束迭代
• Lo-Dash会返回Collection从而允许链式操作，Underscore的返回值则是undefined

Example

Lo-Dash

1 2 3 4 5 6 7 8

_.forEach([1,2,3]) // => 返回[1,2,3] _([1, 2, 3]).forEach(alert).join(','); // => alert每个数字并返回'1,2,3' _.forEach({ 'one': 1, 'two': 2, 'three': 3 }, alert); // => alert每个数字value(不保证按照定义的顺序执行)

Underscore

1 2 3 4

_.each([1, 2, 3], alert); // => alert每个数字 _.each({one : 1, two : 2, three : 3}, alert); // => alert每个数字value(不保证按照定义的顺序执行)

Source

Lo-Dash

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

function forEach(collection, callback, thisArg) { var index = -1, length = collection ? collection.length : 0; callback = callback && typeof thisArg == 'undefined' ? callback : lodash.createCallback(callback, thisArg); if (typeof length == 'number') { while (++index < length) { if (callback(collection[index], index, collection) === false) { break; } } } else { forOwn(collection, callback); } return collection; }

Underscore

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

var each = _.each = _.forEach = function(obj, iterator, context) { if (obj == null) return; if (nativeForEach && obj.forEach === nativeForEach) { obj.forEach(iterator, context); } else if (obj.length === +obj.length) { for (var i = 0, l = obj.length; i < l; i++) { if (iterator.call(context, obj[i], i, obj) === breaker) return; } } else { for (var key in obj) { if (_.has(obj, key)) { if (iterator.call(context, obj[key], key, obj) === breaker) return; } } } };

Additional

• obj.length === +obj.length

+obj: 将obj转换成10进制数，否则返回NaN。因此，上面的判断等价于obj.length && typeof obj.length == 'number'

• if (iterator.call(context, obj[i], i, obj) === breaker) return;

breaker是预先定义的空对象({})，Underscore内部用于提前结束循环的标志，并没有对外公开。另外，因为对象的===比较的是对象地址，所以就算用户在自己的iterator中返回{}，上述if仍然不成立

• for in循环不会遍历non-enumerable属性，因此像Object的toString等就不会被迭代