take

签名: take(count: number): Observable

在完成前发出N个值(N由参数决定)。

为什么使用 take

当只对开头的一组值感兴趣时,你想要的便是 take 操作符。也许你想看看当用户第一次进入页面时,用户首先点击的是什么,你想要订阅点击事件并只取首个值。举例来说,你想要观看赛跑,但其实你只对首先冲过终点的人感兴趣。此操作符很清晰明了,你想要取开头n个值。


:bulb: 如果想基于某个逻辑或另一个 observable 来取任意数量的值,你可以 takeUntiltakeWhile

:bulb: takeskip 是相反的,它接收起始的N个值,而 skip 会跳过起始的N个值。


take - 图3

示例

示例 1: 从源 observable 中取第一个值

( jsBin |
jsFiddle )

  1. import { of } from 'rxjs/observable/of';
  2. import { take } 'rxjs/operators';
  3. // 发出 1,2,3,4,5
  4. const source = of(1, 2, 3, 4, 5);
  5. // 取第一个发出的值然后完成
  6. const example = source.pipe(take(1));
  7. // 输出: 1
  8. const subscribe = example.subscribe(val => console.log(val));
示例 2: 从源 observable 中取前5个值

( jsBin |
jsFiddle )

  1. import { interval } from 'rxjs/observable/interval';
  2. import { take } 'rxjs/operators';
  3. // 每1秒发出值
  4. const interval = interval(1000);
  5. // 取前5个发出的值
  6. const example = interval.pipe(take(5));
  7. // 输出: 0,1,2,3,4
  8. const subscribe = example.subscribe(val => console.log(val));
示例 3: 取得首次点击的坐标

(jsFiddle)

  1. <div id="locationDisplay">
  2. Where would you click first?
  3. </div>
  1. import { fromEvent } from 'rxjs/observable/fromEvent';
  2. import { take, tap } 'rxjs/operators';
  3. const oneClickEvent = fromEvent(document, 'click').pipe(
  4. take(1),
  5. tap(v => {
  6. document.getElementById('locationDisplay').innerHTML
  7. = `Your first click was on location ${v.screenX}:${v.screenY}`;
  8. })
  9. )
  10. const subscribe = oneClickEvent.subscribe();

其他资源


:file_folder: 源码: https://github.com/ReactiveX/rxjs/blob/master/src/internal/operators/take.ts