Mux/multiplex together multiple sync and async iterables or iterators into one async iterator.
npm install async-iterator-muxer> Mux/multiplex together multiple sync and async iterables or iterators into one async iterator.
1. Create a new instance
2. Call .add([iterable]) to add iterable things
3. Iterate over the muxer
4. Optionally, .add more iterables
5. Optionally, call .done.get([iterable]) to see it's final result (if applicable)
``
import AsyncIteratorMuxer from "async-iterator-muxer"
var muxer= new AsyncIteratorMuxer()
// ....
// add some sync & async iterables
muxer.add( myAsyncIterable)
muxer.add( myIterable)
muxer.add( anotherIterable)
// can also add a promise that resolves to something iterable
muxer.add( Promise.resolve([ 4, 5, 6])
// iterate through all outputs as they arrive
for await( var output of muxer){ // for-await must be run inside an async-function, not shown here
console.log( output)
}
muxer.dones.get( myAsyncIterable) // get the return value of myAsyncIterable
``
Please see ./.example/sample-generator.js for a more complete, runnable, well-explained demonstration: it begins multiple asynchronous generators and multiplexes them together into one async iterable.
There's a variety of hooks and modes available, for coercing values during iteration.