mergeall.md

mergeAll

signature: mergeAll(concurrent: number): Observable

Collect and subscribe to all observables.

---

💡 In many cases you can use mergeMap as a single operator instead!

---

Examples

( example tests )

Example 1: mergeAll with promises

( jsBin | jsFiddle )

const myPromise = val => new Promise(resolve => setTimeout(() => resolve(`Result: ${val}`), 2000))
//emit 1,2,3
const source = Rx.Observable.of(1,2,3);

const example = source
  //map each value to promise
  .map(val => myPromise(val))
  //emit result from source
  .mergeAll();

/*
  output:
  "Result: 1"
  "Result: 2"
  "Result: 3"
*/
const subscribe = example.subscribe(val => console.log(val));

Example 2: mergeAll with concurrent parameter

( jsFiddle )

console.clear();

const interval = Rx.Observable.interval(500).take(5);

/*
  interval is emitting a value every 0.5s.  This value is then being mapped to interval that 
  is delayed for 1.0s.  The mergeAll operator takes an optional argument that determines how 
  many inner observables to subscribe to at a time.  The rest of the observables are stored 
  in a backlog waiting to be subscribe.
*/
const example = interval
	.map(val => interval.delay(1000).take(3))
  .mergeAll(2)
  .subscribe(val => console.log(val));
/*
  The subscription is completed once the operator emits all values.
*/

Additional Resources

• mergeAll 📰 - Official docs
• Flatten a higher order observable with mergeAll in RxJS 📹 💵 - André Staltz

---

📁 Source Code: https://github.com/ReactiveX/rxjs/blob/master/src/operator/mergeAll.ts