RxJS آپریٹرز اور flattening آپریٹرز کیا ہیں؟

Question

Accepted Answer

**RxJS operators** Observable سٹریمز کو تبدیل کرتے ہیں، فلٹر کرتے ہیں، اور ان کو یکجا کرتے ہیں۔ سب سے اہم — اور سب سے زیادہ الجھن والے — چار **flattening operators** ہیں جو Observables-of-Observables کو سنبھالتے ہیں (مثلاً ایک HTTP کال جو ایک دوسری سٹریم کے ہر emission سے شروع ہو)۔

## عام transformation/filter آپریٹرز

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

## چار flattening آپریٹرز (مشکل حصہ)

جب کسی source کی ہر value کو **دوسرا** Observable شروع کرنا ہو (جیسے HTTP request)، تو آپ کو اندرونی Observable کو "flatten" کرنا ہوگا۔ یہ چاروں **overlap کو سنبھالنے** میں مختلف ہیں:

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

## ہر ایک کب استعمال کریں

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

## ایک یادگار طریقہ

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

## اہمیت

Flattening operators سب سے اہم — اور اکثر غلط استعمال — RxJS ٹولز میں سے ہیں Angular میں۔

غلط انتخاب حقیقی bugs کا سبب بنتا ہے: search کے لیے `mergeMap` استعمال کرنا پرانے نتائج دکھاتا ہے (کوئی cancellation نہیں)؛ ترتیب وار saves کے لیے `switchMap` استعمال کرنا انہیں درمیان میں منسوخ کر دیتا ہے۔

یہ جاننا کہ `switchMap` منسوخ کرتا ہے (search کے لیے بہترین)، `concatMap` ترتیب دیتا ہے، `mergeMap` متوازی طریقے سے کام کرتا ہے، اور `exhaustMap` نقلیں روکتا ہے، کسی بھی RxJS سے بھرپور Angular code میں صحیح async سنبھالنے کے لیے ضروری ہے۔