import { Observable } from '../Observable'; import { fromArray } from '../observable/fromArray'; import { scalar } from '../observable/scalar'; import { empty } from '../observable/empty'; import { concat as concatStatic } from '../observable/concat'; import { isScheduler } from '../util/isScheduler'; import { MonoTypeOperatorFunction, OperatorFunction, SchedulerLike } from '../types'; /* tslint:disable:max-line-length */ export function startWith(scheduler?: SchedulerLike): MonoTypeOperatorFunction; export function startWith(v1: D, scheduler?: SchedulerLike): OperatorFunction; export function startWith(v1: D, v2: E, scheduler?: SchedulerLike): OperatorFunction; export function startWith(v1: D, v2: E, v3: F, scheduler?: SchedulerLike): OperatorFunction; export function startWith(v1: D, v2: E, v3: F, v4: G, scheduler?: SchedulerLike): OperatorFunction; export function startWith(v1: D, v2: E, v3: F, v4: G, v5: H, scheduler?: SchedulerLike): OperatorFunction; export function startWith(v1: D, v2: E, v3: F, v4: G, v5: H, v6: I, scheduler?: SchedulerLike): OperatorFunction; export function startWith(...array: Array): OperatorFunction; /* tslint:enable:max-line-length */ /** * Returns an Observable that emits the items you specify as arguments before it begins to emit * items emitted by the source Observable. * * First emits its arguments in order, and then any * emissions from the source. * * ![](startWith.png) * * ## Examples * * Start the chain of emissions with `"first"`, `"second"` * * ```javascript * import { of } from 'rxjs'; * import { startWith } from 'rxjs/operators'; * * of("from source") * .pipe(startWith("first", "second")) * .subscribe(x => console.log(x)); * * // results: * // "first" * // "second" * // "from source" * ``` * * @param {...T} values - Items you want the modified Observable to emit first. * @param {SchedulerLike} [scheduler] - A {@link SchedulerLike} to use for scheduling * the emissions of the `next` notifications. * @return {Observable} An Observable that emits the items in the specified Iterable and then emits the items * emitted by the source Observable. * @method startWith * @owner Observable */ export function startWith(...array: Array): OperatorFunction { return (source: Observable) => { let scheduler = array[array.length - 1]; if (isScheduler(scheduler)) { array.pop(); } else { scheduler = null; } const len = array.length; if (len === 1 && !scheduler) { return concatStatic(scalar(array[0] as T), source); } else if (len > 0) { return concatStatic(fromArray(array as T[], scheduler), source); } else { return concatStatic(empty(scheduler), source); } }; }