[6a3a178] | 1 | import { MonoTypeOperatorFunction, SchedulerLike } from '../types';
|
---|
| 2 | /**
|
---|
| 3 | * Ignores source values for `duration` milliseconds, then emits the most recent
|
---|
| 4 | * value from the source Observable, then repeats this process.
|
---|
| 5 | *
|
---|
| 6 | * <span class="informal">When it sees a source value, it ignores that plus
|
---|
| 7 | * the next ones for `duration` milliseconds, and then it emits the most recent
|
---|
| 8 | * value from the source.</span>
|
---|
| 9 | *
|
---|
| 10 | * ![](auditTime.png)
|
---|
| 11 | *
|
---|
| 12 | * `auditTime` is similar to `throttleTime`, but emits the last value from the
|
---|
| 13 | * silenced time window, instead of the first value. `auditTime` emits the most
|
---|
| 14 | * recent value from the source Observable on the output Observable as soon as
|
---|
| 15 | * its internal timer becomes disabled, and ignores source values while the
|
---|
| 16 | * timer is enabled. Initially, the timer is disabled. As soon as the first
|
---|
| 17 | * source value arrives, the timer is enabled. After `duration` milliseconds (or
|
---|
| 18 | * the time unit determined internally by the optional `scheduler`) has passed,
|
---|
| 19 | * the timer is disabled, then the most recent source value is emitted on the
|
---|
| 20 | * output Observable, and this process repeats for the next source value.
|
---|
| 21 | * Optionally takes a {@link SchedulerLike} for managing timers.
|
---|
| 22 | *
|
---|
| 23 | * ## Example
|
---|
| 24 | *
|
---|
| 25 | * Emit clicks at a rate of at most one click per second
|
---|
| 26 | * ```ts
|
---|
| 27 | * import { fromEvent } from 'rxjs';
|
---|
| 28 | * import { auditTime } from 'rxjs/operators';
|
---|
| 29 | *
|
---|
| 30 | * const clicks = fromEvent(document, 'click');
|
---|
| 31 | * const result = clicks.pipe(auditTime(1000));
|
---|
| 32 | * result.subscribe(x => console.log(x));
|
---|
| 33 | * ```
|
---|
| 34 | *
|
---|
| 35 | * @see {@link audit}
|
---|
| 36 | * @see {@link debounceTime}
|
---|
| 37 | * @see {@link delay}
|
---|
| 38 | * @see {@link sampleTime}
|
---|
| 39 | * @see {@link throttleTime}
|
---|
| 40 | *
|
---|
| 41 | * @param {number} duration Time to wait before emitting the most recent source
|
---|
| 42 | * value, measured in milliseconds or the time unit determined internally
|
---|
| 43 | * by the optional `scheduler`.
|
---|
| 44 | * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for
|
---|
| 45 | * managing the timers that handle the rate-limiting behavior.
|
---|
| 46 | * @return {Observable<T>} An Observable that performs rate-limiting of
|
---|
| 47 | * emissions from the source Observable.
|
---|
| 48 | * @method auditTime
|
---|
| 49 | * @owner Observable
|
---|
| 50 | */
|
---|
| 51 | export declare function auditTime<T>(duration: number, scheduler?: SchedulerLike): MonoTypeOperatorFunction<T>;
|
---|