import { Observable } from '../Observable';
import { MonoTypeOperatorFunction } from '../types';
import { operate } from '../util/lift';
import { noop } from '../util/noop';
import { createOperatorSubscriber } from './OperatorSubscriber';
/**
* Emits the most recently emitted value from the source Observable whenever
* another Observable, the `notifier`, emits.
*
* It's like {@link sampleTime}, but samples whenever
* the `notifier` Observable emits something.
*
* ![](sample.png)
*
* Whenever the `notifier` Observable emits a value, `sample`
* looks at the source Observable and emits whichever value it has most recently
* emitted since the previous sampling, unless the source has not emitted
* anything since the previous sampling. The `notifier` is subscribed to as soon
* as the output Observable is subscribed.
*
* ## Example
*
* On every click, sample the most recent `seconds` timer
*
* ```ts
* import { fromEvent, interval, sample } from 'rxjs';
*
* const seconds = interval(1000);
* const clicks = fromEvent(document, 'click');
* const result = seconds.pipe(sample(clicks));
*
* result.subscribe(x => console.log(x));
* ```
*
* @see {@link audit}
* @see {@link debounce}
* @see {@link sampleTime}
* @see {@link throttle}
*
* @param notifier The Observable to use for sampling the
* source Observable.
* @return A function that returns an Observable that emits the results of
* sampling the values emitted by the source Observable whenever the notifier
* Observable emits value or completes.
*/
export function sample(notifier: Observable): MonoTypeOperatorFunction {
return operate((source, subscriber) => {
let hasValue = false;
let lastValue: T | null = null;
source.subscribe(
createOperatorSubscriber(subscriber, (value) => {
hasValue = true;
lastValue = value;
})
);
notifier.subscribe(
createOperatorSubscriber(
subscriber,
() => {
if (hasValue) {
hasValue = false;
const value = lastValue!;
lastValue = null;
subscriber.next(value);
}
},
noop
)
);
});
}