Permalink
Cannot retrieve contributors at this time
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
33 lines (31 sloc)
1.2 KB
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| import arrayEach from './.internal/arrayEach.js' | |
| import baseEach from './.internal/baseEach.js' | |
| /** | |
| * Iterates over elements of `collection` and invokes `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. | |
| * | |
| * @since 0.1.0 | |
| * @alias each | |
| * @category Collection | |
| * @param {Array|Object} collection The collection to iterate over. | |
| * @param {Function} iteratee The function invoked per iteration. | |
| * @returns {Array|Object} Returns `collection`. | |
| * @see forEachRight, forIn, forInRight, forOwn, forOwnRight | |
| * @example | |
| * | |
| * forEach([1, 2], value => console.log(value)) | |
| * // => Logs `1` then `2`. | |
| * | |
| * forEach({ 'a': 1, 'b': 2 }, (value, key) => console.log(key)) | |
| * // => Logs 'a' then 'b' (iteration order is not guaranteed). | |
| */ | |
| function forEach(collection, iteratee) { | |
| const func = Array.isArray(collection) ? arrayEach : baseEach | |
| return func(collection, iteratee) | |
| } | |
| export default forEach |