Kokie yra pagrindiniai RxJS operatoriai ir plokštinimo operatoriai?

Question

Accepted Answer

**RxJS operatoriai** transformuoja, filtruoja ir sujungia Observable srautus. Svarbiausi — ir dažniausiai supainiojami — yra keturi **plokštinimo operatoriai**, kurie tvarko Observable-of-Observable (pvz., HTTP skambutis, kurį suaktyvina kiekvienas kito srauto išleidimas).

## Bendri transformacijos/filtravimo operatoriai

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

## Keturi plokštinimo operatoriai (sudėtinga dalis)

Kai kiekviena šaltinio reikšmė turi suaktyvinti **kitą** Observable (kaip HTTP užklausa), turite "plokštinti" vidinį Observable. Keturi skiriasi **tuo, kaip jie tvarko sutapimus**:

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

## Kada naudoti kiekvieną

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

## Mnemoninė

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

## Kodėl tai svarbu

Plokštinimo operatoriai yra tarp svarbiausių — ir dažniausiai neteisingai naudojamų — RxJS priemonių Angular.

Neteisinga pasirinkimas sukelia tikrus bugs: `mergeMap` naudojimas paieškai parodo pasenusias rezultatus (jokio atšaukimo); `switchMap` naudojimas nuosekliais saugojimais juos atšaukia viduryje.

Žinant, kad `switchMap` atšaukia (idealu paieškai), `concatMap` užsakymą, `mergeMap` lygiagretina, o `exhaustMap` blokuoja duplikatus, yra būtina siekiant teisingai asinchroninio tvarkymo bet kuriame RxJS-sunkiame Angular kode.