ما هي مشغلات RxJS الرئيسية ومشغلات التسطيح؟

Question

Accepted Answer

**مشغلات RxJS** تحول وتصفي وتجمع تدفقات Observable. الأهم منها — والأكثر إرباكاً — هي أربعة **مشغلات تسطيح** تتعامل مع Observables-of-Observables (مثل استدعاء HTTP يُطلقه كل انبعاث من تدفق آخر).

## مشغلات التحويل والتصفية الشائعة

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

## مشغلات التسطيح الأربعة (الجزء الصعب)

عندما تحتاج كل قيمة من مصدر لتشغيل Observable **آخر** (مثل طلب HTTP)، يجب عليك "تسطيح" Observable الداخلي. الأربعة تختلف في **كيفية التعامل مع التداخل**:

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

## لماذا يهم

مشغلات التسطيح من بين أهم — والأكثر إساءة استخدام — أدوات RxJS في Angular.

الاختيار الخاطئ يسبب أخطاء حقيقية: استخدام `mergeMap` للبحث يظهر نتائج قديمة (بلا إلغاء)؛ استخدام `switchMap` للحفظ المتسلسل يلغيها أثناء التنفيذ.

معرفة أن `switchMap` يلغي (مثالي للبحث)، و`concatMap` يرتب، و`mergeMap` يوازي، و`exhaustMap` يحجب النسخ المكررة ضروري للتعامل الصحيح مع العمليات غير المتزامنة في أي كود Angular ثقيل الاستخدام لـ RxJS.