Software Engineer Encyclopedia
0%
Domain 07 · Frontend Engineering with Angular · Topic 7.5

TypeScript المتقدم وRxJS: من Type Safety إلى Streams قابلة للإلغاء

Advanced TypeScript & RxJS — Practical Reactive Programming

Advanced generics/conditional/mapped/template-literal types، type guards، Observable/Subject/BehaviorSubject، map/switchMap/debounceTime، error handling، cancellation، lifecycle، testing وtype-level design.

  • Intermediate
  • ~18 min read
  • 16 sections
  • 15 code examples
  • 1 diagrams
  • 6 questions
  • Priority L2 · Essential
  • TypeScript 5.x · RxJS 7.x · Angular 22

المتطلبات قبل ما تبدأ

أساسيات البرمجة. الـ backend مش شرط لكن بيفيد في جزء الـ HTTP.

مستوى التعمق المطلوب

PRACTICALتدرب | ابني search box بـ debounceTime وswitchMap

01

ليه نحتاج Advanced TypeScript و RxJS؟

Model complex contracts and asynchronous streams
Deep dive

بعد أساسيات TypeScript، هتقابل types أعقد في Angular libraries و generated API clients، وهتقابل Observables في HttpClient و UI events و SignalR. الهدف مش كتابة type gymnastics ولا تحويل كل function إلى stream؛ الهدف تقرأ code متقدم، وتكتب contracts واضحة، وتتعامل مع async flows بدون race conditions أو memory leaks.

TypeScript المتقدم يبني types من types موجودة: generics، mapped types، conditional types، template literal types و infer. RxJS يصف stream من values عبر الزمن؛ تقدر transform/filter/combine/cancel/retry stream. أهم فرق عن Promise: Promise نتيجة واحدة في المستقبل، Observable قد يصدر صفر أو أكثر من القيم، وقد يكون lazy، وله teardown/unsubscribe semantics.

02

switchMap مقابل mergeMap مقابل concatMap مقابل exhaustMap

Higher-order mapping operators
Basics
source:abcswitchMapa✗b✗c → result (cancel previous: search)mergeMapa, b, c all in parallel; results in completion orderconcatMapa then b then c, in order (queue: sequential saves)exhaustMapa; ignore b, c while a runs (double-click on submit)
Same source events (a, b, c), four different concurrency policies for the inner requests
03

Advanced Generics و Constraints

Preserve type relationships across APIs
Deep dive

Generic constraints تقيد T بقدرات مطلوبة. keyof T ينتج union بمفاتيح object، و indexed access T[K] يستخرج type property. استخدم K extends keyof T لتكتب helper يحافظ على العلاقة بين المفتاح والقيمة بدل إرجاع union واسع.

TypeScriptType-safe property access
function getProperty<T, K extends keyof T>(object: T, key: K): T[K] {
  return object[key];
}

const order = { id: 'O-1', total: 250, status: 'Paid' as const };
const total = getProperty(order, 'total'); // number
const status = getProperty(order, 'status'); // 'Paid'

Generic constraints لا تعني runtime validation؛ هي compile-time relationships. لا تستخدم T extends object لو تحتاج key محدد؛ صِف requirement بدقة. ولو generic helper أصبح يحتاج 6 type parameters و conditional branches، فكر هل abstraction فعلاً مفيدة أم أبسط بكتابة function متخصصة.

04

Mapped Types و Conditional Types

Transform object shapes programmatically
Deep dive

Mapped type يمر على keys ويعيد بناء object shape. Conditional type يختار type حسب علاقة assignability: T extends U ? X : Y. يمكن استخدام infer لاستخراج جزء من type. الأدوات دي مفيدة في libraries و form models و API contracts، لكن overuse يجعل type errors صعبة جدًا للمبتدئ.

TypeScriptMapped type for readonly patch model
type MutablePatch<T> = {
  -readonly [K in keyof T]?: T[K];
};

type ApiResult<T> =
  | { ok: true; data: T }
  | { ok: false; error: string };

type SuccessData<T> = T extends { ok: true; data: infer D } ? D : never;
type OrderData = SuccessData<ApiResult<OrderDto>>; // OrderDto

الـ -readonly modifier يزيل readonly، و ? يجعل كل property optional. استخدم utility types الجاهزة لو تؤدي المعنى نفسه؛ custom mapped types مفيدة عندما تحتاج contract خاص متكرر. وثّق الاسم؛ type مثل DeepPartialExceptId يجب أن يكون له سبب واضح واختبارات compile-time.

05

Template Literal Types و Type-Level Programming

Build constrained string contracts
Practical

Template literal types تبني string unions من أجزاء أخرى. مفيدة لأسماء events أو route keys أو CSS token names داخل codebase، لكنها لا تتحقق من string قادم من network وقت runtime. لا تحاول تمثيل كل URL أو SQL grammar كـ type؛ أحيانًا runtime parser أفضل.

TypeScriptEvent names derived from a model
type EntityEvent<T extends string> = `${T}.created` | `${T}.updated` | `${T}.deleted`;
type OrderEvent = EntityEvent<'order'>;
// 'order.created' | 'order.updated' | 'order.deleted'

function publish(event: OrderEvent) {
  console.log(event);
}

Type-level programming ممكن تستخدمها لفرض compile-time rules، لكن compiler performance و error readability جزء من trade-off. لو type instantiation بقت بطيئة أو error message ضخمة، قلل recursion والـ conditional nesting أو انقل جزءًا من validation إلى runtime.

06

Observable: Producer و Subscription و Teardown

A stream with a lifecycle
Deep dive

Observable يصف computation تنتج notifications: next values، error terminal failure، complete نهاية طبيعية. Subscription تبدأ الاستماع، و unsubscribe يوقف الاستماع وينفذ teardown. بعض Observables cold: كل subscription تنشئ execution جديدة مثل HttpClient request غالبًا. وبعضها hot/shared: عدة subscribers يستقبلون نفس source emissions مثل event stream.

TypeScriptCreate and consume a simple Observable
import { Observable } from 'rxjs';

const ticks$ = new Observable<number>(subscriber => {
  let value = 0;
  const timer = setInterval(() => subscriber.next(++value), 1000);
  return () => clearInterval(timer); // teardown on unsubscribe
});

const subscription = ticks$.subscribe(value => console.log(value));
// Later: subscription.unsubscribe();

الرمز $ convention شائع لاسم Observable variable وليس syntax خاص. لا تنشئ interval/timer بلا teardown. لا تعمل subscribe داخل subscribe إذا كان operator مثل switchMap/concatMap يعبّر عن العلاقة بوضوح. Observable لا يعني أن العمل asynchronous بالضرورة؛ يمكن أن يصدر synchronously.

07

Subject و BehaviorSubject

Multicast and current-value streams
Deep dive

Subject يجمع بين Observable و Observer: تقدر تعمل subscribe وتعمل next من producer. BehaviorSubject يحتفظ بآخر قيمة ويصدرها فور subscription جديد، لذلك يحتاج initial value. ReplaySubject يعيد عددًا من القيم السابقة حسب buffer settings. لا تجعل Subject global mutable event bus بلا ownership؛ صعب تتبع من يرسل ومتى.

TypeScriptA small feature state service
import { Injectable } from '@angular/core';
import { BehaviorSubject } from 'rxjs';

@Injectable({ providedIn: 'root' })
export class FilterState {
  private readonly termSubject = new BehaviorSubject('');
  readonly term$ = this.termSubject.asObservable();

  setTerm(value: string) {
    this.termSubject.next(value);
  }
}

Expose asObservable() حتى لا يستطيع consumers استدعاء next مباشرة. في Angular الحديثة، signal قد تكون أبسط للـ synchronous local state؛ Subject مفيد للـ event streams أو interoperability مع RxJS. لا تستخدم BehaviorSubject لتخزين كل server state إذا لم تحدد cache invalidation و loading/error model.

shareReplay و Caching: إمتى يكون خطر؟

shareReplay يشارك subscription ويعيد emissions سابقة للـ late subscribers. مفيد لمنع duplicate HTTP calls داخل feature scope، لكنه قد يحتفظ ببيانات قديمة أو حساسة في memory، وقد لا يعيد fetch عند الحاجة لو lifecycle/configuration غير مناسب. حدد refCount، invalidation، error behavior، tenant/user boundary و logout cleanup.

TypeScriptFeature-scoped shared read example
import { inject } from '@angular/core';
import { HttpClient } from '@angular/common/http';
import { shareReplay } from 'rxjs';

export class OrdersCacheService {
  private readonly http = inject(HttpClient);
  readonly orders$ = this.http.get<OrderDto[]>('/api/orders').pipe(
    shareReplay({ bufferSize: 1, refCount: true })
  );
}

المثال لا يمثل cache policy كاملة: بعد create/update/cancel قد تحتاج invalidate/refetch. لا تشارك response user A مع user B عند logout/login. لا تخزن authorization-sensitive data في global singleton observable بلا session boundary. Server-side caching و HTTP cache headers لهم semantics مختلفة عن RxJS replay.

Subject و BehaviorSubject و shareReplay: State أم Stream؟

Subject multicast events ولا يحتفظ بآخر قيمة. BehaviorSubject يحتفظ بقيمة حالية ويصدرها للمشترك الجديد؛ هذا يجعله state container بسيطًا لكنه mutable source of truth يجب إدارة ownership له. ReplaySubject يعيد آخر N values وقد يحتفظ ببيانات حساسة/كبيرة. shareReplay يشارك subscription ويخزن emissions وفق configuration؛ لا تفترض أن cache تنتهي تلقائيًا في كل استعمال.

حدد refCount و lifecycle و reset behavior وفق RxJS version. shareReplay(1) على HTTP قد يبقي response في الذاكرة أكثر مما تريد. لا تستخدم Subject لمجرد تمرير قيمة synchronous؛ Signal أو plain field قد يكون أبسط. اختبر late subscribers، error completion، unsubscribe، و component destroy.

08

Operators: map و filter و tap و debounceTime

Transform a stream declaratively
Deep dive

Operators تحول Observable إلى Observable جديد. map لتحويل value، filter لاختيار emissions، tap side effect diagnostics بدون تغيير value، debounceTime ينتظر هدوء المصدر قبل إصدار آخر قيمة، distinctUntilChanged يمنع تكرار قيم متساوية حسب comparator، startWith يبدأ بقيمة، و finalize ينفذ cleanup عند complete/error/unsubscribe.

TypeScriptSearch term normalization
import { debounceTime, distinctUntilChanged, map } from 'rxjs';

const normalizedSearch$ = searchInput$.pipe(
  map(value => value.trim()),
  debounceTime(300),
  distinctUntilChanged()
);

ترتيب operators يغير النتيجة: لو debounce قبل trim، inputs مثل "cat" و " cat " قد تؤدي إلى emission مختلفة ثم normalization. غالبًا normalize قبل distinctUntilChanged. لا تستخدم tap لتعديل value أو كبديل عن map؛ خليه side effects واضحة.

09

Higher-Order Observables: switchMap و mergeMap و concatMap و exhaustMap

Choose concurrency semantics deliberately
Deep dive

Higher-order operator يحول كل emission إلى inner Observable ويحدد علاقته بالعمليات السابقة:

  • switchMap: يلغي subscription للـ inner السابق ويشترك في الأحدث. ممتاز للبحث والقراءة التي أصبحت stale.
  • mergeMap: يسمح بتوازي inner streams؛ مناسب لعمليات مستقلة، ويمكن تحديد concurrency limit.
  • concatMap: ينفذ inner streams بالتتابع ويحافظ على order؛ مناسب لعمليات يجب ترتيبها، لكنه قد يكوّن queue متزايدة.
  • exhaustMap: يتجاهل emissions جديدة طالما inner stream الحالية شغالة؛ مناسب لمنع double-submit في بعض flows.
لا تختَر operator عشوائيًااستخدام switchMap مع POST create أو payment قد يلغي انتظار العميل للطلب السابق عندما يصل input جديد، لكنه لا يضمن أن server لم ينفذ العملية. اختَر operator حسب business semantics، واستخدم idempotency على الخادم.
TypeScriptSearch box: debounce + switchMap
import { inject } from '@angular/core';
import { FormControl } from '@angular/forms';
import { catchError, debounceTime, distinctUntilChanged, map, of, switchMap } from 'rxjs';

export class OrderSearchComponent {
  private readonly ordersApi = inject(OrdersApi);
  readonly searchControl = new FormControl('', { nonNullable: true });

  readonly results$ = this.searchControl.valueChanges.pipe(
    map(value => value.trim()),
    debounceTime(300),
    distinctUntilChanged(),
    switchMap(term => term
      ? this.ordersApi.search(term).pipe(catchError(() => of([])))
      : of([])
    )
  );
}

ضع catchError داخل switchMap لو تريد أن يفشل request واحد ثم يستمر stream في استقبال search terms. لو وضعتها خارج switchMap وأرجعت of([])، قد تنتهي stream الأصلية بعد أول error ولا تستجيب للبحث اللاحق. دي من أشهر أخطاء RxJS.

switchMap vs mergeMap vs concatMap vs exhaustMap

هذه operators ليست بدائل شكلية؛ كل واحدة تحدد ماذا يحدث عند وصول source value جديدة أثناء inner observable شغالة. switchMap يلغي subscription السابقة ويهتم بالأحدث، مناسب search suggestions. mergeMap يسمح بتزامن عدة عمليات، مناسب independent uploads مع concurrency limit. concatMap يصطف ويحافظ على الترتيب، مناسب writes التي يجب تنفيذها بالتتابع. exhaustMap يتجاهل source emissions الجديدة أثناء العملية الحالية، مناسب منع double-submit في بعض flows.

TypeScriptSearch: latest request wins
searchTerms$.pipe(
  debounceTime(250),
  distinctUntilChanged(),
  switchMap(term => api.search(term).pipe(
    catchError(() => of([]))
  ))
);

إلغاء HTTP subscription في Angular HttpClient عادةً يلغي request client-side، لكنه لا يضمن أن backend لم يبدأ أو ينفذ side effect. لذلك لا تستخدم switchMap لعمليات دفع أو أوامر لا يجوز إلغاؤها بهذه الطريقة. استخدم concatMap أو idempotency/server command IDs حسب semantics. mergeMap غير المحدود قد يفتح عددًا كبيرًا من requests؛ مرر concurrency limit عند الحاجة.

switchMap vs mergeMap vs concatMap vs exhaustMap

Operatorسلوكهمثالخطر
switchMapيلغي inner السابق ويهتم بالأحدثSearch suggestionsقد يلغي نتيجة مطلوبة لو mutation
mergeMapيشغل inner streams بالتوازيتحميل صور مستقلةترتيب النتائج غير مضمون و concurrency قد تنفجر
concatMapينفذ واحدًا بعد الآخرحفظ تغييرات متسلسلةbacklog إذا producer أسرع من consumer
exhaustMapيتجاهل triggers جديدة أثناء inner الحاليةمنع double submitقد يتجاهل آخر input للمستخدم

لا تختَر operator من الاسم؛ اكتب invariant: هل الأحدث يلغي السابق؟ هل كل request يجب أن تنفذ؟ هل الترتيب مهم؟ هل نسمح بالتوازي؟ ثم اختبر rapid clicks و slow network و errors و component destruction. استخدم mergeMap(project, concurrency) لتحديد حد التوازي بدل إطلاق مئات requests.

Backpressure و Concurrency Limits في RxJS

بعض sources تنتج events أسرع من قدرة consumer على المعالجة: scroll، websocket، file stream، أو user input. debounceTime ينتظر الهدوء؛ throttleTime يحد المعدل؛ bufferTime يجمع events؛ sampleTime يأخذ آخر قيمة على فترات. هذه ليست interchangeable: اختَر حسب معنى البيانات. لا تستخدم debounce على audit events يجب ألا تضيع.

في mergeMap حدد concurrency، واستخدم queue/backpressure policy واضحة. إذا producer أسرع دائمًا، queue ستكبر حتى نفاد الذاكرة ما لم تسقط/تدمج/تبطئ المصدر أو تنقل العمل إلى server queue. اختبر burst traffic، slow consumer، tab backgrounding، reconnect، و unsubscribe. راقب queue length و dropped events.

RxJS Operator Choice Checklist

حدد هل تريد latest-wins أو parallel أو sequential أو ignore-while-busy، ثم اختر switchMap/mergeMap/concatMap/exhaustMap. حدد أين يجب catchError حتى لا يموت outer stream، وهل retry آمن، وما lifetime لل subscription، وهل source hot أو cold، وهل shareReplay cache مقصودة. اختبر timing و cancellation بدل افتراض السلوك من الاسم.

10

Combining Streams: combineLatest و forkJoin و withLatestFrom

Coordinate independent asynchronous sources
Deep dive

combineLatest ينتظر أول emission من كل source ثم يصدر كلما أي source يتغير، مستخدم للـ filters + route params + data state. forkJoin ينتظر كل sources تكمل ثم يصدر آخر قيمة لكل واحد؛ مناسب لعدة HTTP calls مستقلة finite. withLatestFrom يصدر عند source الأساسي فقط ويضم آخر قيم من streams مساعدة، مثل click event مع current form state.

TypeScriptLoad dashboard resources in parallel
import { forkJoin } from 'rxjs';

const dashboard$ = forkJoin({
  profile: this.http.get<ProfileDto>('/api/profile'),
  orders: this.http.get<OrderDto[]>('/api/orders'),
  summary: this.http.get<OrderSummary>('/api/orders/summary')
});

لو أحد sources في forkJoin لا يكمل أبدًا، forkJoin لن يصدر. لو source يكمل من غير أي value، النتيجة قد تكون empty completion. HttpClient requests finite عادة، لكن WebSocket/Subject streams ليست كذلك. لا تستخدم forkJoin على long-lived stream بلا take(1) أو completion strategy.

11

Error Handling و Retry في RxJS

Errors terminate a stream unless handled
Deep dive

في RxJS، error notification تنهي Observable. catchError يستبدل stream ب Observable آخر، و retry يعيد subscription عند error. Retry مناسب لبعض transient failures فقط، ويجب أن يكون محدودًا مع backoff/jitter واحترام Retry-After. لا تعيد validation errors أو 401 بشكل أعمى. لا تجعل retry على POST غير idempotent.

TypeScriptBounded retry with delay
import { retry, timer } from 'rxjs';

const resilientRead$ = this.http.get<OrderDto[]>('/api/orders').pipe(
  retry({
    count: 2,
    delay: (_error, retryIndex) => timer(retryIndex * 500)
  })
);

المثال يوضح delay تصاعدي بسيط وليس production exponential backoff كامل. لا تعمل retry على كل errors؛ افحص HttpErrorResponse status وصنف transient 502/503/504/network مقابل 400/401/403/404. وحط total timeout budget حتى لا تظل الشاشة loading مدة غير محدودة.

RxJS Error و Retry و Cancellation Semantics

catchError يستبدل error stream بمصدر جديد؛ مكانه داخل inner observable يختلف عن وضعه خارج switchMap. لو وضعته خارج السلسلة كلها، خطأ request واحد قد ينهي stream الخاصة بالـ search input. Retry مناسب للأخطاء transient مثل بعض network failures و429/503 وفق Retry-After، وليس لأخطاء validation أو unauthorized. استخدم bounded retries مع backoff/jitter.

TypeScriptSearch stream survives request failures
export class SearchService {
  readonly results$ = this.query$.pipe(
    debounceTime(250),
    distinctUntilChanged(),
    switchMap(query => this.api.search(query).pipe(
      retry({ count: 2, delay: (error, retryCount) =>
        timer(Math.min(1000 * 2 ** retryCount, 5000))
      }),
      catchError(() => of([]))
    ))
  );
}

switchMap يلغي subscription السابقة، لكن هل يوقف HTTP فعلًا يعتمد على Observable implementation؛ Angular HttpClient يدعم cancellation عند unsubscribe. لا تستخدم retry لعملية mutation إلا مع idempotency key أو contract يمنع التكرار. اعرض loading/error state منفصلين بدل إخفاء كل failure في empty array إذا كان المستخدم يحتاج معرفة الخطأ.

Completion و Error و Unsubscription ليست نفس الشيء

Observable قد تكمل بـ complete أو تفشل بـ error أو يتم unsubscribe قبل النهاية. finalize يعمل في المسارات الثلاثة، بينما complete callback لا يعمل عند error أو unsubscribe. هذا مهم لإيقاف loading indicators وتنظيف resources. لا تستخدم take(1) إذا source تحتاج تظل مستمرة، ولا تفترض أن HTTP Observable stream لا يمكن إلغاؤها.

Hot Observable قد تنتج قبل الاشتراك، و Cold Observable تبدأ العمل لكل subscriber؛ share/shareReplay تغير subscription semantics. راجع multicast و refCount حتى لا تكرر HTTP calls أو تحتفظ ب stream بعد انتهاء component. اختبر completion/error/unsubscribe بشكل منفصل.

12

Unsubscription و Memory Leaks في Angular

Tie stream lifetime to its owner
Deep dive

HttpClient Observable finite غالبًا، لكن streams مثل valueChanges, router events, WebSocket, Subject و interval قد تكون طويلة. لو component تختفي وما عملتش unsubscribe، callback قد يفضل محتفظًا بالـ component أو يحدّث state بعد destruction. استخدم async pipe في template، أو takeUntilDestroyed() في injection context، أو toSignal() عند تحويل stream إلى signal.

TypeScripttakeUntilDestroyed in a component
import { Component, DestroyRef, inject } from '@angular/core';
import { takeUntilDestroyed } from '@angular/core/rxjs-interop';

@Component({ selector: 'app-audit', template: '' })
export class AuditComponent {
  private readonly destroyRef = inject(DestroyRef);

  ngOnInit() {
    this.auditEvents.events$
      .pipe(takeUntilDestroyed(this.destroyRef))
      .subscribe(event => this.handle(event));
  }
}

لا تستخدم subscribe() لمجرد عرض data لو async pipe يفي بالغرض. لكن subscribe مقبول عند imperative side effect واضح، مع lifecycle cleanup. لا تعمل nested subscribe؛ استخدم flattening operator حتى تملك cancellation/error flow في مكان واحد.

Lifecycle و Memory Leaks: Subscription ownership

Observable قد تكون cold: كل subscription تبدأ execution جديدة، أو hot/shared: عدة subscribers يشاركون source. لا تفترض أن Observable معناها request واحدة. shareReplay قد يحتفظ بآخر قيمة وبـ source subscription؛ configuration و refCount وسلوك completion تؤثر في lifetime. لا تستخدمه كـ cache دائم بلا invalidation.

في Angular الحديثة استخدم async pipe أو takeUntilDestroyed حيث يناسبان، وتجنب subscribe داخل subscribe. اجعل pipeline declarative واستخدم switchMap/withLatestFrom/combineLatest حسب semantics. في imperative subscription، حدد owner والـ teardown، خصوصًا للـ interval و DOM events و websocket. HTTP finite streams عادةً تكمل تلقائيًا، لكن ذلك لا يعني أن كل stream كذلك.

Subscription Ownership

قبل subscribe اسأل: من المسؤول عن unsubscribe؟ component، service، app shell أم stream نفسها؟ استخدم async pipe أو takeUntilDestroyed في component، وراجع service streams التي تعيش طوال التطبيق. subscription غير مملوكة بوضوح مصدر شائع للـ memory leaks و duplicate side effects.

13

Testing Observables و Marble Testing

Test time and concurrency behavior
Practical

اختبر stream behavior: input sequence، debounce timing، cancellation، ordering، error recovery و completion. Angular tests قد تستخدم fakeAsync/tick أو RxJS TestScheduler حسب نوع stream. Marble testing يسمح بتمثيل الزمن والقيم بصريًا، لكنه يحتاج تعلم syntax و scheduler semantics. لا تختبر كل operator في RxJS نفسه؛ اختبر pipeline business التي كتبتها.

TypeScriptTest a debounce pipeline with TestScheduler (sketch)
import { TestScheduler } from 'rxjs/testing';
import { debounceTime } from 'rxjs';

const scheduler = new TestScheduler((actual, expected) => {
  expect(actual).toEqual(expected);
});

scheduler.run(({ cold, expectObservable }) => {
  const source = cold('a--b----c---|');
  const result = source.pipe(debounceTime(2));
  expectObservable(result).toBe('--a--b----c-|');
});

راجع frame expectations عند تغيير debounce duration؛ marble diagram test يعتمد على virtual time وليس wall-clock. اختبر error path داخل switchMap حتى تتأكد إن stream تظل تستقبل search input بعد فشل request واحدة.

Testing RxJS: Marble Tests و Virtual Time

اختبار stream تعتمد على debounce/retry/delay باستخدام setTimeout و sleep يجعلها بطيئة وهشة. RxJS TestScheduler يسمح بتحديد virtual time واختبار emissions/errors/completion بشكل deterministic. اكتب marble diagrams للـ source والـ expected output، وغطِّ cancellation و inner error behavior. Angular HttpTestingController يختبر HTTP requests، لكنه لا يغني عن اختبار operators نفسها.

اختبر subscription lifetime لتجنب leaks، وراجع أن switchMap يلغي الطلب السابق، و concatMap يحافظ على الترتيب، و mergeMap لا يتجاوز concurrency limit. لا تختبر implementation تفاصيل غير مهمة؛ اختبر stream contract الذي تعتمد عليه الشاشة.

Debug RxJS Pipelines

عندما stream لا تصدر، افحص source subscription و filter conditions و completion/error. أضف tap مؤقتًا عند boundaries المهمة، لا في كل operator، وسجل trace-safe metadata فقط. استخدم RxJS DevTools أو marble tests عند تعقيد timing. لا تترك debug taps تسجل payloads حساسة في production.

راقب subscriptions التي لا تنتهي، خصوصًا Subjects و WebSocket streams. takeUntilDestroyed/async pipe يربط lifetime بال component، لكن service-level streams قد تحتاج owner مختلفًا. إذا ظهر duplicate HTTP request، افحص هل observable cold وهل أكثر من subscriber يشترك دون sharing مقصود.

RxJS Final Debug Checklist

قبل اعتماد pipeline، اختبر empty source، single emission، multiple emissions، error، completion، unsubscribe، late subscriber، rapid input، slow inner observable، و component destroy. تأكد من أن error لا تنهي outer UI stream بلا قصد، وأن retry bounded، وأن side effects لا تتكرر بسبب تعدد subscribers. اكتب marble test عندما timing semantics أساسية للـ feature.

14

Type Safety في RxJS Pipelines

Avoid widening everything to any
Deep dive

حافظ على generic types عبر operators: map يحول T إلى U، filter يمكن أن يستخدم type predicate، و switchMap يحافظ على inner Observable result. اكتب DTO types دقيقة، واستخدم discriminated unions لحالات loading/error/success. لو API ترجع unknown، validate قبل ما تبني UI assumptions.

TypeScriptFilter with a type predicate
type SearchResult = OrderDto | CustomerDto;

function isOrder(value: SearchResult): value is OrderDto {
  return 'total' in value && 'status' in value;
}

const ordersOnly$ = mixedResults$.pipe(filter(isOrder));

لو type inference فقد النوع بعد custom operator أو library boundary، ابدأ من signature بدل cast. استخدم `Observable للstream التي لا تصدر value وتكمل/ترمي خطأ في بعض scenarios، ولا تخلط Observable مع Observable` بلا سبب.

تصميم Stream Contract قبل كتابة Operators

وثّق لكل stream: هل هي cold أم hot؟ هل تصدر قيمة ابتدائية؟ هل يمكن أن تكمل؟ هل error تنهيها أم تتحول إلى state؟ من يملك subscription؟ هل events يمكن إسقاطها أو إعادة ترتيبها؟ هل مصدرها cancellable؟ هذه الأسئلة تمنع استخدام operators بشكل عشوائي. اسم observable مثل orderUpdates$ يجب يوضح هل هو snapshot أم events delta.

افصل domain events عن UI state snapshots. لو stream تعرض current state للمشترك الجديد، استخدم behavior/replay semantics بوعي. لو تمثل حدثًا لا يجب تكراره، لا تجعل replay يسبب side effect مرتين. اختبر late subscriber و reconnect و duplicate event و completion.

15

اختيار RxJS أو Signal أو Promise

Use the simplest reactive model
Deep dive
الحالةاختيار مبدئيالسبب
قيمة محلية حالية في componentSignalقراءة/اشتقاق مباشر وسهل
عملية async واحدة بنتيجة واحدةPromise أو Observable حسب APIPromise بسيطة؛ HttpClient يعيد Observable
بحث يتغير باستمرار مع cancellationObservable + debounce + switchMapstream operators تصف الزمن والـ cancellation
WebSocket/SignalR eventsObservable adapter أو callback APIقيم متعددة على مدى الزمن
State مشتقة synchronouscomputed signalلا تحتاج stream pipeline

Signals و RxJS متكاملان وليس أحدهما بديلًا مطلقًا للآخر. لا تحول كل signal إلى Observable ثم تعيدها signal من غير سبب. اجعل boundary واضحة: signal للـ view state، Observable للـ async/event streams، و service يدير server communication.

16

اختبر فهمك

Knowledge check
Practical
ما الفرق الأساسي بين Promise و Observable؟
Promise نتيجة واحدة مستقبلية؛ Observable stream قد يصدر صفر أو أكثر من القيم ويمكن إلغاء subscription.
متى تستخدم switchMap؟
لعمليات latest-wins مثل البحث حيث تصبح نتيجة الطلب السابق stale عند وصول input جديد.
لماذا catchError داخل switchMap غالبًا أفضل للبحث؟
لأنه يعالج فشل request واحدة ويترك outer input stream تعمل لعمليات البحث التالية.
ما الفرق بين concatMap و mergeMap؟
concatMap ينفذ inner streams بالتتابع ويحافظ على الترتيب؛ mergeMap يسمح بالتوازي.
هل unsubscribe يضمن إلغاء العملية على الخادم؟
لا؛ يوقف subscription/العميل حيثما أمكن، لكن server قد يكون بدأ التنفيذ بالفعل.
ما خطر shareReplay؟
قد يحتفظ ببيانات stale أو حساسة؛ تحتاج invalidation وحدود session/user واضحة.
↗

المراجع والقراءة الإضافية

References & further reading

الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)

خريطة التغطية: 18 عنصر من الـ Roadmap ومكان شرحه في الدرس
New sectionGenerics and Advanced Types§01
New sectionUtility and Mapped Types§01
New sectionType Guards and Narrowing§01
New sectionRxJS: Observable, Subject, BehaviorSubject§01
New sectionOperators: map, switchMap, debounceTime§01
New sectionError handling in streams§01
SuggestedGenerics and Advanced Types§01
SuggestedUtility and Mapped Types§01
SuggestedType Guards and Narrowing§01
SuggestedRxJS: Observable, Subject, BehaviorSubject§01
SuggestedOperators: map, switchMap, debounceTime§01
SuggestedError handling in streams§01
SuggestedConditional Types§01
SuggestedTemplate Literal Types§01
SuggestedHigher-order Observables§01
SuggestedUnsubscription Patterns§01
SuggestedTesting Observables§01
SuggestedType-level programming§01

خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.

محتويات الدرس