import { Observable } from '../Observable'; import { Operator } from '../Operator'; import { Subscriber } from '../Subscriber'; import { Observer } from '../Observer'; import { EmptyError } from '../util/EmptyError'; import { TeardownLogic } from '../Subscription'; import { MonoTypeOperatorFunction } from '../interfaces'; /** * Returns an Observable that emits the single item emitted by the source Observable that matches a specified * predicate, if that Observable emits one such item. If the source Observable emits more than one such item or no * such items, notify of an IllegalArgumentException or NoSuchElementException respectively. * * * * @throws {EmptyError} Delivers an EmptyError to the Observer's `error` * callback if the Observable completes before any `next` notification was sent. * @param {Function} predicate - A predicate function to evaluate items emitted by the source Observable. * @return {Observable} An Observable that emits the single item emitted by the source Observable that matches * the predicate. . * @method single * @owner Observable */ export function single(predicate?: (value: T, index: number, source: Observable) => boolean): MonoTypeOperatorFunction { return (source: Observable) => source.lift(new SingleOperator(predicate, source)); } class SingleOperator implements Operator { constructor(private predicate?: (value: T, index: number, source: Observable) => boolean, private source?: Observable) { } call(subscriber: Subscriber, source: any): TeardownLogic { return source.subscribe(new SingleSubscriber(subscriber, this.predicate, this.source)); } } /** * We need this JSDoc comment for affecting ESDoc. * @ignore * @extends {Ignored} */ class SingleSubscriber extends Subscriber { private seenValue: boolean = false; private singleValue: T; private index: number = 0; constructor(destination: Observer, private predicate?: (value: T, index: number, source: Observable) => boolean, private source?: Observable) { super(destination); } private applySingleValue(value: T): void { if (this.seenValue) { this.destination.error('Sequence contains more than one element'); } else { this.seenValue = true; this.singleValue = value; } } protected _next(value: T): void { const index = this.index++; if (this.predicate) { this.tryNext(value, index); } else { this.applySingleValue(value); } } private tryNext(value: T, index: number): void { try { if (this.predicate(value, index, this.source)) { this.applySingleValue(value); } } catch (err) { this.destination.error(err); } } protected _complete(): void { const destination = this.destination; if (this.index > 0) { destination.next(this.seenValue ? this.singleValue : undefined); destination.complete(); } else { destination.error(new EmptyError); } } }