@segment/legacy-each

Iterate over a collection, invoking a function for each element.

Usage no npm install needed!

<script type="module">
  import segmentLegacyEach from 'https://cdn.skypack.dev/@segment/legacy-each';
</script>

README

Iterate over a collection, invoking a function for each element in the collection.

Installation

$ npm install @segment/legacy-each

API

`each(iterator : Function, collection : Array|Object|string) => undefined`

Iterate over an input collection, invoking an iterator function for each element in the collection, passing to the iterator three arguments: (value, index, collection).

The iterator function can end iteration early by returning false.

var log = console.log.bind(console);

each(log, ['a', 'b', 'c']);
//-> 'a', 0, ['a', 'b', 'c']
//-> 'b', 1, ['a', 'b', 'c']
//-> 'c', 2, ['a', 'b', 'c']
//=> undefined

each(log, 'tim');
//-> 't', 2, 'tim'
//-> 'i', 1, 'tim'
//-> 'm', 0, 'tim'
//=> undefined

// Note: Iteration order not guaranteed across environments
each(log, { name: 'tim', occupation: 'enchanter' });
//-> 'tim', 'name', { name: 'tim', occupation: 'enchanter' }
//-> 'enchanter', 'occupation', { name: 'tim', occupation: 'enchanter' }
//=> undefined

License

Released under the MIT license.