forEach each source npm
_.forEach(collection, [iteratee=_.identity])
Iterates over elements of collection
invoking iteratee
for each element.
The iteratee is invoked with three arguments: (value, index|key, collection).
Iteratee functions may exit iteration early by explicitly returning false
.
Note: As with other "Collections" methods, objects with a "length" property
are iterated like arrays. To avoid this behavior use _.forIn
or _.forOwn
for object iteration.
Arguments
- collection (Array|Object)
The collection to iterate over.
- [iteratee=_.identity] (Function)
The function invoked per iteration.
Returns (Array|Object)
Returns collection
.
Example
_([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)