import { Operator } from '../Operator'; import { Observable } from '../Observable'; import { Subscriber } from '../Subscriber'; import { MonoTypeOperatorFunction, TeardownLogic } from '../types'; import { innerSubscribe, SimpleInnerSubscriber, SimpleOuterSubscriber } from '../innerSubscribe'; /** * Emits the values emitted by the source Observable until a `notifier` * Observable emits a value. * * Lets values pass until a second Observable, * `notifier`, emits a value. Then, it completes. * * ![](takeUntil.png) * * `takeUntil` subscribes and begins mirroring the source Observable. It also * monitors a second Observable, `notifier` that you provide. If the `notifier` * emits a value, the output Observable stops mirroring the source Observable * and completes. If the `notifier` doesn't emit any value and completes * then `takeUntil` will pass all values. * * ## Example * Tick every second until the first click happens * ```ts * import { fromEvent, interval } from 'rxjs'; * import { takeUntil } from 'rxjs/operators'; * * const source = interval(1000); * const clicks = fromEvent(document, 'click'); * const result = source.pipe(takeUntil(clicks)); * result.subscribe(x => console.log(x)); * ``` * * @see {@link take} * @see {@link takeLast} * @see {@link takeWhile} * @see {@link skip} * * @param {Observable} notifier The Observable whose first emitted value will * cause the output Observable of `takeUntil` to stop emitting values from the * source Observable. * @return {Observable} An Observable that emits the values from the source * Observable until such time as `notifier` emits its first value. * @method takeUntil * @owner Observable */ export function takeUntil(notifier: Observable): MonoTypeOperatorFunction { return (source: Observable) => source.lift(new TakeUntilOperator(notifier)); } class TakeUntilOperator implements Operator { constructor(private notifier: Observable) { } call(subscriber: Subscriber, source: any): TeardownLogic { const takeUntilSubscriber = new TakeUntilSubscriber(subscriber); const notifierSubscription = innerSubscribe(this.notifier, new SimpleInnerSubscriber(takeUntilSubscriber)); if (notifierSubscription && !takeUntilSubscriber.seenValue) { takeUntilSubscriber.add(notifierSubscription); return source.subscribe(takeUntilSubscriber); } return takeUntilSubscriber; } } /** * We need this JSDoc comment for affecting ESDoc. * @ignore * @extends {Ignored} */ class TakeUntilSubscriber extends SimpleOuterSubscriber { seenValue = false; constructor(destination: Subscriber, ) { super(destination); } notifyNext(): void { this.seenValue = true; this.complete(); } notifyComplete(): void { // noop } }