RxJS tap

对源 Observable 上的每个发射执行副作用，但返回与源相同的 Observable。

tap<T>(nextOrObserver?: NextObserver<T> |ErrorObserver<T> | CompletionObserver<T> | ((x: T) => void), error?: (e: any) => void, complete?: () => void): MonoTypeOperatorFunction<T>

参量

nextOrObserver	可选的。默认值为undefined。普通的 Observer 对象或的回调next。
错误	可选的。默认值为undefined。回调源中的错误。
完成	可选的。默认值为undefined。回调以完成源。

returns

MonoTypeOperatorFunction<T>：与源相同的 Observable，但为每个项目运行指定的 Observer 或 callback。

描述

拦截源上的每个发射并运行一个函数，但是只要不发生错误，就返回与源相同的输出。

返回源 Observable 的镜像 Observable，但已对其进行了修改，以便调用提供的 Observer 对源发出的每个值，错误和完成执行副作用。在上述 Observer 或处理程序中引发的任何错误都将沿着输出 Observable 的错误路径安全地发送。

该运算符可用于调试 Observable 的正确值或执行其他副作用。

注意：这subscribe与 Observable 上的有所不同。如果tap未订阅由返回的 Observable，则 Observer 指定的副作用将永远不会发生。tap因此，仅监视现有执行，就不会触发执行subscribe。

例

将每次点击映射到该点击的 clientX 位置，同时记录点击事件

import { fromEvent } from 'rxjs';
import { tap, map } from 'rxjs/operators';


const clicks = fromEvent(document, 'click');
const positions = clicks.pipe(
  tap(ev => console.log(ev)),
  map(ev => ev.clientX),
);
positions.subscribe(x => console.log(x));

超载

tap(next: null, error: null, complete: () => void): MonoTypeOperatorFunction<T>

参量	类型
next	类型：null
错误	类型：null
完成	类型：() => void

returnsMonoTypeOperatorFunction<T> tap(next: null, error: (error: any) => void, complete?: () => void): MonoTypeOperatorFunction<T>

参量	类型
next	类型：null
错误	类型：(error: any) => void
完成	可选的。默认值为undefined。类型：() => void

returnsMonoTypeOperatorFunction<T>

tap(next: (value: T) => void, error: null, complete: () => void): MonoTypeOperatorFunction<T>

参量	类型
next	类型：(value: T) => void
错误	类型：null
完成	类型：() => void

returnsMonoTypeOperatorFunction<T>

tap(next?: (x: T) => void, error?: (e: any) => void, complete?: () => void): MonoTypeOperatorFunction<T>

参量	类型
next	可选的。默认值为undefined。类型：(x: T) => void
错误	可选的。默认值为undefined。类型：(e: any) => void
完成	可选的。默认值为undefined。类型：() => void

returnsMonoTypeOperatorFunction<T>

tap(observer: PartialObserver<T>): MonoTypeOperatorFunction<T>

参量	类型
观察者	类型：PartialObserver

returnsMonoTypeOperatorFunction<T>

也可以看看

• map
• Observable