UNPKG

@reactivex/rxjs

Version:

Reactive Extensions for modern JavaScript

74 lines 2.63 kB
"use strict"; Object.defineProperty(exports, "__esModule", { value: true }); var Observable_1 = require("../Observable"); var async_1 = require("../scheduler/async"); var isNumeric_1 = require("../util/isNumeric"); /** * Creates an Observable that emits sequential numbers every specified * interval of time, on a specified {@link SchedulerLike}. * * <span class="informal">Emits incremental numbers periodically in time. * </span> * * ![](interval.png) * * `interval` returns an Observable that emits an infinite sequence of * ascending integers, with a constant interval of time of your choosing * between those emissions. The first emission is not sent immediately, but * only after the first period has passed. By default, this operator uses the * `async` {@link SchedulerLike} to provide a notion of time, but you may pass any * {@link SchedulerLike} to it. * * ## Example * Emits ascending numbers, one every second (1000ms) up to the number 3 * ```ts * import { interval } from 'rxjs'; * import { take } from 'rxjs/operators'; * * const numbers = interval(1000); * * const takeFourNumbers = numbers.pipe(take(4)); * * takeFourNumbers.subscribe(x => console.log('Next: ', x)); * * // Logs: * // Next: 0 * // Next: 1 * // Next: 2 * // Next: 3 * ``` * * @see {@link timer} * @see {@link delay} * * @param {number} [period=0] The interval size in milliseconds (by default) * or the time unit determined by the scheduler's clock. * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for scheduling * the emission of values, and providing a notion of "time". * @return {Observable} An Observable that emits a sequential number each time * interval. * @static true * @name interval * @owner Observable */ function interval(period, scheduler) { if (period === void 0) { period = 0; } if (scheduler === void 0) { scheduler = async_1.async; } if (!isNumeric_1.isNumeric(period) || period < 0) { period = 0; } if (!scheduler || typeof scheduler.schedule !== 'function') { scheduler = async_1.async; } return new Observable_1.Observable(function (subscriber) { subscriber.add(scheduler.schedule(dispatch, period, { subscriber: subscriber, counter: 0, period: period })); return subscriber; }); } exports.interval = interval; function dispatch(state) { var subscriber = state.subscriber, counter = state.counter, period = state.period; subscriber.next(counter); this.schedule({ subscriber: subscriber, counter: counter + 1, period: period }, period); } //# sourceMappingURL=interval.js.map