tap.md

tap

Сигнатура

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

Параметры

• nextOrObserver

  Функция срабатывающая на next или частичный объект типа Observer

• error Опционально

  Функция срабатывающая на error принимает в качестве параметра объект ошибки

• complete Опционально

  Функция срабатывающая на complete

Описание

Выполняет функции полученные из параметров, никак не влияя на полученные значения

Примеры

Пример 1: Логирование перед и после оператора map

// RxJS v6+
import { of } from 'rxjs';
import { tap, map } from 'rxjs/operators';

const source = of(1, 2, 3, 4, 5);
// transparently log values from source with 'tap'
const example = source.pipe(
  tap(val => console.log(`BEFORE MAP: ${val}`)),
  map(val => val + 10),
  tap(val => console.log(`AFTER MAP: ${val}`))
);

//'tap' does not transform values
//output: 11...12...13...14...15
const subscribe = example.subscribe(val => console.log(val));

Пример 2: Использование tap передавая ему объект

// RxJS v6+
import { of } from 'rxjs';
import { tap, map } from 'rxjs/operators';

const source = of(1, 2, 3, 4, 5);

// tap also accepts an object map to log next, error, and complete
const example = source
  .pipe(
    map(val => val + 10),
    tap({
      next: val => {
        // on next 11, etc.
        console.log('on next', val);
      },
      error: error => {
        console.log('on error', error.message);
      },
      complete: () => console.log('on complete')
    })
  )
  // output: 11, 12, 13, 14, 15
  .subscribe(val => console.log(val));

Полезные ссылки

• 📰 Официальная документация: tap
• 📁 Исходный код: https://github.com/ReactiveX/rxjs/blob/master/src/internal/operators/tap.ts