Quali sono i principali operatori RxJS e gli operatori di flattening?

Question

Accepted Answer

**Gli operatori RxJS** trasformano, filtrano e combinano flussi Observable. I più importanti — e i più confusi — sono i quattro **operatori di flattening** che gestiscono Observable-di-Observable (ad es. una chiamata HTTP attivata da ogni emissione di un altro flusso).

## Operatori comuni di trasformazione/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
);
```

## I quattro operatori di flattening (la parte complicata)

Quando ogni valore da una sorgente deve attivare **un altro** Observable (come una richiesta HTTP), devi "appiattire" l'Observable interno. I quattro differiscono nel **modo in cui gestiscono la sovrapposizione**:

```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 usare ciascuno

```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
```

## Un mnemonico

```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
```

## Perché è importante

Gli operatori di flattening sono tra i più importanti — e più comunemente usati male — strumenti RxJS in Angular.

Scegliere in modo sbagliato causa bug reali: usare `mergeMap` per la ricerca mostra risultati obsoleti (nessuna cancellazione); usare `switchMap` per i salvataggi sequenziali li cancella a metà percorso.

Sapere che `switchMap` cancella (ideale per la ricerca), `concatMap` ordina, `mergeMap` parallelizza, e `exhaustMap` blocca i duplicati è essenziale per la corretta gestione asincrona in qualsiasi codice Angular ricco di RxJS.