exhaustmap.md

exhaustMap

signature: exhaustMap(project: function, resultSelector: function): Observable

Map to inner observable, ignore other values until that observable completes.

Examples

Example 1: exhaustMap with interval

( jsBin | jsFiddle )

const interval = Rx.Observable.interval(1000);
const delayedInterval = interval.delay(10).take(4);

const exhaustSub = Rx.Observable.merge(
  // delay 10ms, then start interval emitting 4 values
  delayedInterval,
  // emit immediately
  Rx.Observable.of(true)
)
  /*
   *  The first emitted value (of(true)) will be mapped 
   *  to an interval observable emitting 1 value every 
   *  second, completing after 5.
   *  Because the emissions from the delayed interval 
   *  fall while this observable is still active they will be ignored.
   *
   *  Contrast this with concatMap which would queue, 
   *  switchMap which would switch to a new inner observable each emission,
   *  and mergeMap which would maintain a new subscription for each emitted value.
   */
  .exhaustMap(_ => interval.take(5))
  // output: 0, 1, 2, 3, 4
  .subscribe(val => console.log(val));

Example 2: Another exhaustMap with interval

( jsBin | jsFiddle )

const firstInterval = Rx.Observable.interval(1000).take(10);
const secondInterval = Rx.Observable.interval(1000).take(2);

const exhaustSub = firstInterval
  .do(i => console.log(`Emission of first interval: ${i}`))
  .exhaustMap(f => secondInterval)
  /*
  When we subscribed to the first interval, it starts to emit a values (startinng 0).
  This value is mapped to the second interval which then begins to emit (starting 0).  
  While the second interval is active, values from the first interval are ignored.
  We can see this when firstInterval emits number 3,6, and so on...
  
    Output:
    Emission of first interval: 0
    0
    1
    Emission of first interval: 3
    0
    1
    Emission of first interval: 6
    0
    1
    Emission of first interval: 9
    0
    1
*/
  .subscribe(s => console.log(s));

Additional Resources

• exhaustMap 📰 - Official docs

---

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