lat. to repeat, to iterate
ES6 Iterator library for applying multiple transformations to a collection in a single iteration.
Ever wanted to iterate over ES6 collections like
Lets say you have a large
Set of URIs and want to get a
Set back that contains file paths from all
The loop solution is very clumsy and not very functional:
const uris =''''''const paths =for const uri of urisif !uricontinueconst path = uripaths
Much more readable is converting the
Set to an array, using its methods and then converting back:
But there is a problem: Instead of iterating once, you iterate 4 times (one time for converting, one time for filtering, one time for mapping, one time for converting back). For a large Set with thousands of elements, this has significant overhead.
Other libraries like RxJS or plain NodeJS streams would support these kinds of "pipelines" without multiple iterations, but they work only asynchronously.
With this library you can use many methods you know and love from
Array and lodash while only iterating once - thanks to the ES6 iterator protocol:
iterate accepts any kind of Iterator or Iterable (arrays, collections, generators, ...) and returns a new Iterator object that can be passed to any Iterable-accepting function (collection constructors,
for of, ...).
Only when you call a method like
reduce() or pass it to a
for of loop will each value get pulled through the pipeline, and only once.
This library is essentially
Benchmark based on the example above:
|Loop||225 ops/sec ±1.87% (73 runs sampled)|
|iterare||211 ops/sec ±2.79% (73 runs sampled)|
|Array method chain||132 ops/sec ±1.84% (73 runs sampled)|
|Lodash (with lazy evalution)||179 ops/sec ±1.67% (77 runs sampled)|
|RxJS||204 ops/sec ±1.69% (75 runs sampled)|
Going a step further, if you only care about a specific number of elements in the end, only these elements will run through the pipeline:
In this example, the filter predicate is called only until 5 elements have been found. The alternative with an array would call it for every element in the collection:
The source is written in TypeScript.
npm run buildcompiles TS
npm run watchcompiles on file changes
npm testruns tests
node lib/benchmarks/____runs a benchmark