MDN self-hosted library · e01.org

Observable: takeUntil() method

Observable API

no runnable cells web-api-instance-method upstream source

Observable API

The takeUntil() method of the Observable interface returns a new observable that emits values from the source observable until another observable emits a value or errors.

Syntax

takeUntil(value)

Parameters

  • value
  • : A value that can be converted to an observable by Observable.from(): an Observable, a Promise, an iterable object, or an async iterable object. The converted observable acts as the notifier that determines when to stop emitting source values.

Return value

A new Observable. When subscribed to, it emits values from the source observable until the notifier emits a value or errors, then completes and unsubscribes from both observables. If the source completes or errors first, that notification is forwarded and the notifier is unsubscribed from.

Exceptions

  • TypeError
  • : Thrown if value cannot be converted to an observable.

Description

Like other observable-returning operators, this method is lazy: calling it creates a new observable without subscribing to the source. Processing starts when the returned observable is subscribed to.

The notifier is subscribed to before the source. If it emits a value or errors synchronously, the returned observable completes without subscribing to the source. If the notifier completes without emitting a value, the source continues uninterrupted.

A notifier error completes the returned observable successfully; it is not forwarded as an error.

You can technically pass a synchronous iterable as the value, but the converted observable either never emits if the iterable is empty (and takeUntil() never unsubscribes), or it immediately emits if the iterable is non-empty (and takeUntil() immediately unsubscribes).

Examples

Using takeUntil()

This example displays the mouse coordinates when the pointer moves over either of two <div> elements. Clicking anywhere in the example completes the observable and stops coordinate reporting. Click Restart after the stream ends to try again.

```html hidden live-sample___basic-takeuntil


```css hidden live-sample___basic-takeuntil
div {
  height: 120px;
  background-color: purple;
  margin-bottom: 40px;
}

```js live-sample___basic-takeuntil const outputElem = document.querySelector("p");

const restart = document.querySelector("#restart");

function start() { restart.disabled = true; outputElem.textContent = "Move the mouse"; document.body .when("mousemove") .filter((e) => e.target.matches("div")) .map((e) => ({ x: e.clientX, y: e.clientY })) .takeUntil( document.body.when("click").filter((event) => event.target !== restart), ) .subscribe({ next: reportCoords, complete() { restart.disabled = false; }, });

function reportCoords(e) { outputElem.textContent = ${e.x},${e.y}; } }

restart.when("click").subscribe(start); start(); ```

Specifications

Browser compatibility

See also