import {Observable} from '../Observable'; import {Operator} from '../Operator'; import {Subscriber} from '../Subscriber'; import {OperatorFunction} from '../types'; export function find(predicate: (value: T, index: number, source: Observable) => value is S, thisArg?: any): OperatorFunction; export function find(predicate: (value: T, index: number, source: Observable) => boolean, thisArg?: any): OperatorFunction; /** * Emits only the first value emitted by the source Observable that meets some * condition. * * Finds the first value that passes some test and emits * that. * * ![](find.png) * * `find` searches for the first item in the source Observable that matches the * specified condition embodied by the `predicate`, and returns the first * occurrence in the source. Unlike {@link first}, the `predicate` is required * in `find`, and does not emit an error if a valid value is not found. * * ## Example * Find and emit the first click that happens on a DIV element * ```ts * import { fromEvent } from 'rxjs'; * import { find } from 'rxjs/operators'; * * const clicks = fromEvent(document, 'click'); * const result = clicks.pipe(find(ev => ev.target.tagName === 'DIV')); * result.subscribe(x => console.log(x)); * ``` * * @see {@link filter} * @see {@link first} * @see {@link findIndex} * @see {@link take} * * @param {function(value: T, index: number, source: Observable): boolean} predicate * A function called with each item to test for condition matching. * @param {any} [thisArg] An optional argument to determine the value of `this` * in the `predicate` function. * @return {Observable} An Observable of the first item that matches the * condition. * @method find * @owner Observable */ export function find(predicate: (value: T, index: number, source: Observable) => boolean, thisArg?: any): OperatorFunction { if (typeof predicate !== 'function') { throw new TypeError('predicate is not a function'); } return (source: Observable) => source.lift(new FindValueOperator(predicate, source, false, thisArg)) as Observable; } export class FindValueOperator implements Operator { constructor(private predicate: (value: T, index: number, source: Observable) => boolean, private source: Observable, private yieldIndex: boolean, private thisArg?: any) { } call(observer: Subscriber, source: any): any { return source.subscribe(new FindValueSubscriber(observer, this.predicate, this.source, this.yieldIndex, this.thisArg)); } } /** * We need this JSDoc comment for affecting ESDoc. * @ignore * @extends {Ignored} */ export class FindValueSubscriber extends Subscriber { private index: number = 0; constructor(destination: Subscriber, private predicate: (value: T, index: number, source: Observable) => boolean, private source: Observable, private yieldIndex: boolean, private thisArg?: any) { super(destination); } private notifyComplete(value: any): void { const destination = this.destination; destination.next(value); destination.complete(); this.unsubscribe(); } protected _next(value: T): void { const {predicate, thisArg} = this; const index = this.index++; try { const result = predicate.call(thisArg || this, value, index, this.source); if (result) { this.notifyComplete(this.yieldIndex ? index : value); } } catch (err) { this.destination.error(err); } } protected _complete(): void { this.notifyComplete(this.yieldIndex ? -1 : undefined); } }