find

Emits only the first value emitted by the source Observable that meets some condition.

find<T>(predicate: (value: T, index: number, source: Observable<T>) => boolean, thisArg?: any): OperatorFunction<T, T | undefined>

Parameters

predicate	A function called with each item to test for condition matching.
thisArg	Optional. Default is undefined. An optional argument to determine the value of this in the predicate function.

Returns

OperatorFunction<T, T | undefined>: A function that returns an Observable that emits the first item that matches the condition.

Description

Finds the first value that passes some test and emits that.

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 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

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));

Overloads

find(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>

Parameters

predicate

Type: BooleanConstructor.

Returns

OperatorFunction<T, TruthyTypesOf<T>>

find(predicate: (this: A, value: T, index: number, source: Observable<T>) => value is S, thisArg: A): OperatorFunction<T, S | undefined>

Parameters

predicate	Type: (this: A, value: T, index: number, source: Observable) => value is S.
thisArg	Type: A.

Returns

OperatorFunction<T, S | undefined>

find(predicate: (value: T, index: number, source: Observable<T>) => value is S): OperatorFunction<T, S | undefined>

Parameters

predicate

Type: (value: T, index: number, source: Observable) => value is S.

Returns

OperatorFunction<T, S | undefined>

find(predicate: (this: A, value: T, index: number, source: Observable<T>) => boolean, thisArg: A): OperatorFunction<T, T | undefined>

Parameters

predicate	Type: (this: A, value: T, index: number, source: Observable) => boolean.
thisArg	Type: A.

Returns

OperatorFunction<T, T | undefined>

find(predicate: (value: T, index: number, source: Observable<T>) => boolean): OperatorFunction<T, T | undefined>

Parameters

predicate

Type: (value: T, index: number, source: Observable) => boolean.

Returns

OperatorFunction<T, T | undefined>

See Also

• filter
• first
• findIndex
• take