仅发出源 Observable 发出的第一个值（或满足某些条件的第一个值）。

first<T, D>(predicate?: (value: T, index: number, source:Observable<T>) => boolean, defaultValue?: D): OperatorFunction<T, T | D>

参量

returns

OperatorFunction<T, T | D>：符合条件的第一项的可观察值。

投掷

EmptyError``error 如果 Observable 在 next发送任何通知之前完成，则将 EmptyError 传递给 Observer 的回调。

描述

仅发出第一个值。或仅发出通过某些测试的第一个值。

如果不带任何参数调用，则first发出源 Observable 的第一个值，然后完成。如果使用 predicate函数调用，则 first 发出与指定条件匹配的源的第一个值。还可能不建议使用 resultSelector函数，以根据输入值生成输出值 defaultValue，如果源在发出有效值之前完成，则发出a。如果 defaultValue未提供则抛出错误， 并且找不到匹配的元素。

例子

仅发出发生在 DOM 上的第一次点击

import { fromEvent } from 'rxjs';
import { first } from 'rxjs/operators';


const clicks = fromEvent(document, 'click');
const result = clicks.pipe(first());
result.subscribe(x => console.log(x));

发出 DIV 发生的第一次点击

import { fromEvent } from 'rxjs';
import { first } from 'rxjs/operators';


const clicks = fromEvent(document, 'click');
const result = clicks.pipe(first(ev => ev.target.tagName === 'DIV'));
result.subscribe(x => console.log(x));

超载

first(predicate?: null, defaultValue?: D): OperatorFunction<T, T | D>

returnsOperatorFunction<T, T | D>

first(predicate: (value: T, index: number, source: Observable<T>) => value is S, defaultValue?: S): OperatorFunction<T, S>

returnsOperatorFunction<T, S>

first(predicate: (value: T, index: number, source: Observable<T>) => boolean, defaultValue?: D): OperatorFunction<T, T | D>

也可以看看

• filter
• find
• take