Quais são os operadores chave do RxJS e os operadores de achatamento?

Question

Accepted Answer

**Operadores do RxJS** transformam, filtram e combinam fluxos de Observable. Os mais importantes — e mais confundidos — são os quatro **operadores de achatamento** que lidam com Observables-de-Observables (por exemplo, uma chamada HTTP acionada por cada emissão de outro fluxo).

## Operadores comuns de transformação/filtro

```ts
import { map, filter, tap, debounceTime, distinctUntilChanged, catchError } from "rxjs/operators";

source$.pipe(
  map(x => x * 2),                 // transform each value
  filter(x => x > 10),             // keep values passing a test
  tap(x => console.log(x)),        // side effect, doesn't change the stream
  debounceTime(300),               // wait for a pause before emitting (search inputs)
  distinctUntilChanged(),          // ignore consecutive duplicates
);
```

## Os quatro operadores de achatamento (a parte complicada)

Quando cada valor de uma fonte precisa acionar **outro** Observable (como uma requisição HTTP), você deve "achatar" o Observable interno. Os quatro diferem em **como lidam com sobreposição**:

```text
switchMap   → cancels the previous inner Observable when a new value arrives
mergeMap    → runs all inner Observables concurrently (no cancellation)
concatMap   → queues them, runs one at a time in order
exhaustMap  → ignores new values while an inner Observable is still running
```

## Quando usar cada um

```ts
// switchMap — type-ahead search: cancel the stale request when the user types again
this.searchInput.valueChanges.pipe(
  debounceTime(300),
  switchMap(query => this.api.search(query)) // only the LATEST query's result matters
).subscribe(results => this.results = results);

// mergeMap — fire independent requests in parallel (order doesn't matter)
from(ids).pipe(mergeMap(id => this.api.get(id)));

// concatMap — operations that MUST run in order (e.g. sequential saves)
actions$.pipe(concatMap(action => this.api.save(action)));

// exhaustMap — ignore repeated clicks while a login is in flight
this.loginClick$.pipe(exhaustMap(() => this.auth.login())); // ignore spam clicks
```

## Uma mnemônica

```text
switchMap  = "switch to the new one" (cancel old) → search
mergeMap   = "merge all" (parallel)              → independent requests
concatMap  = "concatenate" (sequential)          → ordered operations
exhaustMap = "exhaust current first" (ignore new) → prevent double-submit
```

## Por que isso importa

Os operadores de achatamento estão entre as ferramentas RxJS mais importantes — e mais comumente mal utilizadas — em Angular.

Escolher errado causa bugs reais: usar `mergeMap` para busca mostra resultados obsoletos (sem cancelamento); usar `switchMap` para salvamentos sequenciais os cancela em voo.

Saber que `switchMap` cancela (ideal para busca), `concatMap` ordena, `mergeMap` paraleliza, e `exhaustMap` bloqueia duplicatas é essencial para tratamento assíncrono correto em qualquer código Angular pesado em RxJS.