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, SchedulerLike, OperatorFunction } from '../types'; /* tslint:disable:max-line-length */ export function endWith(scheduler?: SchedulerLike): MonoTypeOperatorFunction; export function endWith(v1: A, scheduler?: SchedulerLike): OperatorFunction; export function endWith(v1: A, v2: B, scheduler?: SchedulerLike): OperatorFunction; export function endWith(v1: A, v2: B, v3: C, scheduler?: SchedulerLike): OperatorFunction; export function endWith(v1: A, v2: B, v3: C, v4: D, scheduler?: SchedulerLike): OperatorFunction; export function endWith(v1: A, v2: B, v3: C, v4: D, v5: E, scheduler?: SchedulerLike): OperatorFunction; export function endWith(v1: A, v2: B, v3: C, v4: D, v5: E, v6: F, scheduler?: SchedulerLike): OperatorFunction; export function endWith(...array: Array): OperatorFunction; /* tslint:enable:max-line-length */ /** * Returns an Observable that emits the items you specify as arguments after it finishes emitting * items emitted by the source Observable. * * ![](endWith.png) * * ## Example * ### After the source observable completes, appends an emission and then completes too. * * ```javascript * import { of } from 'rxjs'; * import { endWith } from 'rxjs/operators'; * * of('hi', 'how are you?', 'sorry, I have to go now').pipe( * endWith('goodbye!'), * ) * .subscribe(word => console.log(word)); * // result: * // 'hi' * // 'how are you?' * // 'sorry, I have to go now' * // 'goodbye!' * ``` * * @param {...T} values - Items you want the modified Observable to emit last. * @param {SchedulerLike} [scheduler] - A {@link SchedulerLike} to use for scheduling * the emissions of the `next` notifications. * @return {Observable} An Observable that emits the items emitted by the source Observable * and then emits the items in the specified Iterable. * @method endWith * @owner Observable */ export function endWith(...array: Array): MonoTypeOperatorFunction { 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(source, scalar(array[0] as T)); } else if (len > 0) { return concatStatic(source, fromArray(array as T[], scheduler)); } else { return concatStatic(source, empty(scheduler)); } }; }