ignoreElements

function stable

Ignores all items emitted by the source Observable and only passes calls of complete or error.

ignoreElements(): OperatorFunction<any, never>

Parameters

There are no parameters.

Returns

OperatorFunction<any, never>: A function that returns an empty Observable that only calls complete or error, based on which one is called by the source Observable.

Description

ignoreElements marble diagram

The IgnoreElements operator suppresses all of the items emitted by the source Observable, but allows its termination notification (either error or complete) to pass through unchanged.

If you do not care about the items being emitted by an Observable, but you do want to be notified when it completes or when it terminates with an error, you can apply the ignoreElements operator to the Observable, which will ensure that it will never call its observers’ next handlers.

Examples

import { of } from 'rxjs';
import { ignoreElements } from 'rxjs/operators';

of('you', 'talking', 'to', 'me').pipe(
  ignoreElements(),
)
.subscribe(
  word => console.log(word),
  err => console.log('error:', err),
  () => console.log('the end'),
);
// result:
// 'the end'

© 2015–2021 Google, Inc., Netflix, Inc., Microsoft Corp. and contributors.
Code licensed under an Apache-2.0 License. Documentation licensed under CC BY 4.0.
https://rxjs.dev/api/operators/ignoreElements