zip

Combina varios Observables para crear otro Observable cuyos valores se calculen a partir de las emisiones, en orden, de cada uno de sus Observables de entrada

Signatura

Firma

zip<O extends ObservableInput<any>, R>(...observables: (O | ((...values: ObservedValueOf<O>[]) => R))[]): Observable<ObservedValueOf<O>[] | R>

Parámetros

Retorna

Observable<ObservedValueOf<O>[] | R>

Descripción

Si el último parámetro es una función, esta se utiliza para computar el valor creado a partir de los valores de entrada. Si no, se retorna un array de los valores de entrada.

Ejemplos

Esperar a que dos Observables emitan un valor, y emitir ambos valores en un array

StackBlitz

import { zip, timer } from "rxjs";
import { mapTo } from "rxjs/operators";

const hello$ = timer(2000).pipe(mapTo("Hello"));
const world$ = timer(4000).pipe(mapTo("World"));

zip(hello$, world$).subscribe(console.log);
// Salida: ['Hello', 'World']

Al combinarlo con interval (o timer), zip puede utilizarse para emitir los valores de un Observable cada cierto tiempo. Ej: Emitir una cadena cada vez que interval emite (cada segundo)

StackBlitz

import { from, interval, zip } from "rxjs";
import { map } from "rxjs/operators";

const framework$ = zip(from(["Angular", "React", "Vue"]), interval(1000)).pipe(
  map(([framework]) => framework)
);

framework$.subscribe(console.log);
// Salida: (1s) Angular (1s) React (1s) Vue

Ejemplo de la documentación oficial

Combinar la edad y el nombre de distintas fuentes

import { zip, of } from "rxjs";
import { map } from "rxjs/operators";

let age$ = of < number > (27, 25, 29);
let name$ = of < string > ("Foo", "Bar", "Beer");
let isDev$ = of < boolean > (true, true, false);

zip(age$, name$, isDev$)
  .pipe(map(([age, name, isDev]) => ({ age, name, isDev })))
  .subscribe((x) => console.log(x));

// Salida
// { age: 27, name: 'Foo', isDev: true }
// { age: 25, name: 'Bar', isDev: true }
// { age: 29, name: 'Beer', isDev: false }

Sobrecargas

Firma

zip(v1: O1, resultSelector: (v1: ObservedValueOf<O1>) => R): Observable<R>

Parámetros

Retorna

Observable<R>

Firma

zip(v1: O1, v2: O2, resultSelector: (v1: ObservedValueOf<O1>, v2: ObservedValueOf<O2>) => R): Observable<R>

Parámetros

Retorna

Observable<R>

Firma

zip(v1: O1, v2: O2, v3: O3, resultSelector: (v1: ObservedValueOf<O1>, v2: ObservedValueOf<O2>, v3: ObservedValueOf<O3>) => R): Observable<R>

Parámetros

Retorna

Observable<R>

Firma

zip(v1: O1, v2: O2, v3: O3, v4: O4, resultSelector: (v1: ObservedValueOf<O1>, v2: ObservedValueOf<O2>, v3: ObservedValueOf<O3>, v4: ObservedValueOf<O4>) => R): Observable<R>

Parámetros

Retorna

Observable<R>

Firma

zip(v1: O1, v2: O2, v3: O3, v4: O4, v5: O5, resultSelector: (v1: ObservedValueOf<O1>, v2: ObservedValueOf<O2>, v3: ObservedValueOf<O3>, v4: ObservedValueOf<O4>, v5: ObservedValueOf<O5>) => R): Observable<R>

Parámetros

Retorna

Observable<R>

Firma

zip(v1: O1, v2: O2, v3: O3, v4: O4, v5: O5, v6: O6, resultSelector: (v1: ObservedValueOf<O1>, v2: ObservedValueOf<O2>, v3: ObservedValueOf<O3>, v4: ObservedValueOf<O4>, v5: ObservedValueOf<O5>, v6: ObservedValueOf<O6>) => R): Observable<R>

Parámetros

Retorna

Observable<R>

Firma

zip(v1: O1, v2: O2): Observable<[ObservedValueOf<O1>, ObservedValueOf<O2>]>

Parámetros

Retorna

Observable<[ObservedValueOf<O1>, ObservedValueOf<O2>]>

Firma

zip(v1: O1, v2: O2, v3: O3): Observable<[ObservedValueOf<O1>, ObservedValueOf<O2>, ObservedValueOf<O3>]>

Parámetros

Retorna

Observable<[ObservedValueOf<O1>, ObservedValueOf<O2>, ObservedValueOf<O3>]>

Firma

zip(v1: O1, v2: O2, v3: O3, v4: O4): Observable<[ObservedValueOf<O1>, ObservedValueOf<O2>, ObservedValueOf<O3>, ObservedValueOf<O4>]>

Parámetros

Retorna

Observable<[ObservedValueOf<O1>, ObservedValueOf<O2>, ObservedValueOf<O3>, ObservedValueOf<O4>]>

Firma

zip(v1: O1, v2: O2, v3: O3, v4: O4, v5: O5): Observable<[ObservedValueOf, ObservedValueOf, ObservedValueOf, ObservedValueOf<O4>, ObservedValueOf<O5>]>

Parámetros

Retorna

Observable<[ObservedValueOf<O1>, ObservedValueOf<O2>, ObservedValueOf<O3>, ObservedValueOf<O4>, ObservedValueOf<O5>]>

Firma

zip(v1: O1, v2: O2, v3: O3, v4: O4, v5: O5, v6: O6): Observable<[ObservedValueOf<O1>, ObservedValueOf<O2>, ObservedValueOf<O3>, ObservedValueOf<O4>, ObservedValueOf<O5>, ObservedValueOf<O6>]>

Parámetros

Retorna

Observable<[ObservedValueOf<O1>, ObservedValueOf<O2>, ObservedValueOf<O3>, ObservedValueOf<O4>, ObservedValueOf<O5>, ObservedValueOf<O6>]>

Firma

zip(array: O[]): Observable<ObservedValueOf<O>[]>

Parámetros

Retorna

Observable<ObservedValueOf<O>[]>

Firma

zip(array: any[]): Observable<R>

Parámetros

Retorna

Observable<R>

Firma

zip(array: O[], resultSelector: (...values: ObservedValueOf<O>[]) => R): Observable<R>

Parámetros

Retorna

Observable<R>

Firma

zip(array: any[], resultSelector: (...values: any[]) => R): Observable<R>

Parámetros

Retorna

Observable<R>

Firma

zip(...observables: O[]): Observable<ObservedValueOf<O>[]>

Parámetros

Retorna

Observable<ObservedValueOf<O>[]>

Firma

zip(...observables: (O | ((...values: ObservedValueOf<O>[]) => R))[]): Observable<R>

Parámetros

Retorna

Observable<R>

Firma

zip(...observables: any[]): Observable<R>

Parámetros

Retorna

Observable<R>

Recursos adicionales

Documentación oficial en inglés