Mitkä ovat RxJS:n keskeiset operaattorit ja litistysoperaattorit?

Question

Accepted Answer

**RxJS-operaattorit** muuntavat, suodattavat ja yhdistävät Observable-virtoja. Tärkeimmät — ja usein väärinymmärretyt — ovat neljä **litistysoperaattoria**, jotka käsittelevät Observables-of-Observables -rakenteita (esim. HTTP-kutsu, jonka toinen virta laukaisee jokaisella emissiolla).

## Yleiset muunnos-/suodatusoperaattorit

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

## Neljä litistysoperaattoria (vaikea osa)

Jos jokainen lähteen arvo joutuu laukaisemaan **toisen** Observable-virran (kuten HTTP-pyynnön), sinun on "litistettävä" sisäinen Observable. Neljä eroavat toisistaan **päällekkäisyyden käsittelyssä**:

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

## Milloin käyttää kutakin

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

## Muistisääntö

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

## Miksi tämä on tärkeää

Litistysoperaattorit ovat RxJS:n tärkeimmistä — ja eniten väärinkäytetyistä — työkaluista Angularissa.

Väärä valinta aiheuttaa oikeita bugeja: `mergeMap`-käyttö hakuihin näyttää vanhentuneita tuloksia (ei peruutusta); `switchMap`-käyttö peräkkäisille tallennuksille peruuttaa ne lennon aikana.

Tieto siitä, että `switchMap` peruuttaa (ihanteellinen hakuun), `concatMap` järjestää, `mergeMap` rinnakkaistaa ja `exhaustMap` estää kaksoiskappaleet, on välttämätöntä oikean asynkronisen käsittelyn kannalta missä tahansa RxJS-raskaassa Angular-koodissa.