يعني إيه Modern Angular؟
Modern Angular مش مجرد تغيير syntax. الاتجاه الحالي يعتمد standalone components، signals للتفاعلية، functional providers/interceptors/guards، control flow blocks، lazy route loading، و SSR/hydration عند الحاجة. بعض APIs تتطور بسرعة؛ راجع status/version في roadmap و docs قبل اعتماد preview/developer-preview API في production.
المهم إنك تفهم boundaries: component state، feature state، server state، route state، authentication/session state. لا تحط كل شيء في global store، ولا تخلط Observable و Signal بلا سبب. اختَر abstraction حسب شكل data flow والـ lifecycle.
Signals graph في رسمة
Standalone و Feature-Based Architecture
في standalone architecture، كل component/directive/pipe يعلن imports التي يحتاجها. الـ Router يحمل feature عند الحاجة عبر loadComponent أو loadChildren. feature folders تجمع pages/components/services/models الخاصة بالقدرة business مثل Orders و Customers و Auth. shared للمكونات العامة الحقيقية، و core للخدمات على مستوى التطبيق، وليس dumping ground.
قاعدة عملية: page component تنسق view، child components تعرض أجزاء reusable، feature service يدير API/state الخاص بال feature، و global core services للتكوين/session/telemetry. لا تجعل component تعرف تفاصيل SQL/EF أو تنفذ business authorization. ولا تجعل service عامة تحتوي كل endpoints لكل domains.
Feature Boundaries و Standalone Components
نظم frontend حسب feature مثل Orders و Catalog و Account، وليس مجلدات عامة ضخمة لكل components/services/models. اجعل public API لكل feature محددة، وقلل cross-feature imports الداخلية. Standalone components/directives/pipes تقلل module ceremony، لكنها لا تعني أن كل component يحتاج ملفًا منفصلًا أو abstraction. lazy route boundary قد تكون feature boundary جيدة.
شارك UI primitives/design system عندما يوجد reuse حقيقي، لكن لا تضع business-specific component في shared لمجرد أنه يستخدم مرتين. راجع dependency graph ومنع cycles. اكتب naming conventions و barrel exports بحذر؛ barrel files قد تخفي dependency direction أو تسبب circular import.
Signals بعمق: computed و effect و linkedSignal و Resource APIs
signal تمثل writable state، computed مشتقة، effect side effect. linkedSignal يمكن أن يربط writable state بقيمة مشتقة مع إمكانية override حسب API/version، و resource/httpResource تقدم APIs للتعامل مع asynchronous data في Angular الحديثة. لا تستخدم effect لتحديث signal مشتقة من signal أخرى؛ استخدم computed لتجنب loops و glitches.
import { computed, signal } from '@angular/core';
const quantity = signal(2);
const unitPrice = signal(125);
const total = computed(() => quantity() * unitPrice());
function setQuantity(value: number) {
if (!Number.isInteger(value) || value < 1) return;
quantity.set(value);
}Signals تتبع dependencies عند القراءة. لو computed تقرأ signal داخل branch، dependency set قد تتغير حسب execution. حافظ على computed pure؛ لا تعمل HTTP call أو mutate external state بداخلها. effect يحتاج cleanup عند الاشتراك في event source أو timer. لا تجعل effect ينسخ state من مكان إلى آخر بلا حاجة.
Resource APIs قد تبسط async read state، لكن لا تفترض أنها بديل كامل لـ RxJS لكل stream. HTTP request one-shot تختلف عن WebSocket stream أو complex event orchestration. افحص error/loading/reload/cancellation semantics في API version المستخدمة.
Signals Effects و Cleanup: لا تضع Business Derivation في Effect
computed مشتق pure من signals أخرى؛ effect مناسب ل side effect مثل sync إلى browser API أو analytics أو integration مع imperative library. لا تستخدم effect لتحديث signal أخرى كبديل عن computed؛ هذا قد يخلق cycles أو ordering bugs. عند effect يملك timer/listener/subscription، نظف resource عند rerun أو destroy باستخدام cleanup.
@Component({ selector: 'app-clock', template: '{{ now() }}' })
export class ClockComponent {
readonly now = signal(new Date());
private readonly ticker = effect((onCleanup) => {
const timerId = window.setInterval(() => this.now.set(new Date()), 1000);
onCleanup(() => window.clearInterval(timerId));
});
}المثال browser-only؛ في SSR استخدم platform-aware clock/timer abstraction بدل الوصول المباشر إلى window. لا تستخدم effect لتحديث UI state يمكن اشتقاقها بـ computed. راقب أن side effect لا يتكرر بلا داعٍ بسبب قراءة signal إضافية داخل callback.
Signals و linkedSignal و resource: اختيار الأداة الصحيحة
ابدأ بتقسيم state حسب مصدره: source state يملكه المستخدم أو server، وderived state يمكن حسابه منه. استخدم signal لقيمة محلية قابلة للتغيير، و computed لقيمة مشتقة pure، و linkedSignal عندما تحتاج قيمة قابلة للتعديل لكن يجب أن تتزامن مع تغيّر source وفق قاعدة واضحة. لا تنسخ كل state إلى signals متعددة؛ هذا يخلق حالات متعارضة.
import { computed, signal } from '@angular/core';
interface Product { id: string; price: number; }
export class ProductState {
readonly products = signal<Product[]>([]);
readonly selectedId = signal<string | null>(null);
readonly selectedProduct = computed(() =>
this.products().find(p => p.id === this.selectedId()) ?? null
);
readonly total = computed(() =>
this.products().reduce((sum, p) => sum + p.price, 0)
);
}في المثال، selectedProduct مشتق ولا يحتاج تخزينًا منفصلًا. لو كانت selection قابلة للتعديل لكن يجب reset عند تغيير parent source، فكّر في linkedSignal بدل effect ينسخ القيمة؛ effects مناسبة للـ side effects والتكامل مع APIs خارج reactive graph، وليست بديلًا عن computed.
resource وواجهات async المرتبطة به تتطور عبر إصدارات Angular؛ راجع حالة API والـ stability في docs الخاصة بالإصدار قبل اعتمادها في production. استخدمها عندما تناسب read-oriented async state، ولا تفترض أنها بديل تلقائي لكل RxJS stream أو mutation workflow. RxJS يظل مناسبًا للـ events، cancellation، composition، WebSocket و complex async orchestration.
Signal Forms و Reactive Forms و Dynamic Forms
Signal Forms الحديثة تربط form model بـ signals و FieldTree، وتسمح بقراءة value/validity/interaction state reactive. Reactive Forms ما زالت خيارًا ناضجًا واسع الاستخدام، خصوصًا في codebases الحالية و complex forms. لا تهاجر form مستقرة لمجرد أن API أحدث؛ قيّم validation، custom controls، team familiarity، testing و library compatibility.
import { signal } from '@angular/core';
import { form, required, email } from '@angular/forms/signals';
interface LoginModel {
email: string;
password: string;
}
const model = signal<LoginModel>({ email: '', password: '' });
const loginForm = form(model, path => {
required(path.email);
email(path.email);
required(path.password);
});راجع import names و API stability في Angular release المستهدف؛ المثال يوضح model-driven concept. لا تخلط Signal Forms validators مع Reactive Forms validators من غير adapter. Server-side validation تظل إلزامية، ولا ترسل password أو sensitive form values في logs.
Dynamic forms تتولد من metadata/schema مثل field type/label/validators/options. metadata يجب تكون trusted/versioned، ولا تسمح server response بتحويل arbitrary string إلى executable component/class. صمم allow-list من field renderers و validators. اختبر hidden/disabled/conditional fields، nested arrays، async validation و accessibility.
Change Detection و OnPush و Zoneless
Change detection تحدد متى Angular تراجع template bindings وتحدث DOM. OnPush يقلل checks غير الضرورية اعتمادًا على signals/input/event scheduling. في Angular الحديثة، OnPush أصبح default في الاتجاه الحالي، و zoneless change detection stable/default حسب roadmap الحالية؛ لكن apps قديمة أو migrated projects قد تختلف. افحص bootstrap/configuration الفعلي ولا تفترض Zone.js behavior من tutorial قديم.
أفضل تحسين غالبًا هو state ownership و immutable updates و signals/computed و track keys وتقسيم components، وليس manual ChangeDetectorRef في كل مكان. لا تستخدم detectChanges() لإخفاء race condition أو update خارج Angular model. لو تستخدم third-party library imperative، اربط callback بالـ framework reactivity بطريقة صحيحة.
راقب performance من browser Performance panel و Angular DevTools: change detection cycles، component tree، long tasks، layout shifts و large lists. OnPush لا يعالج API overfetch أو expensive computed loops أو DOM آلاف العناصر وحده.
Change Detection و OnPush و Performance Profiling
OnPush يقلل فحص component subtree وفق triggers مثل input changes و events و signal updates و async pipe notifications؛ لا يعني أن component لا يعاد فحصها مطلقًا. Signals تساعد في granular reactive updates، لكن template functions المكلفة و lists بلا tracking جيد قد تظل بطيئة.
استخدم stable track keys في @for، و lazy-load routes، وراقب bundle budgets، وتجنب إرسال objects ضخمة إلى children إذا كانت references تتغير كل render. لا تضف memoization بلا قياس. استخدم Angular DevTools و browser Performance panel لمعرفة change detection time و long tasks و layout shifts. Zoneless configuration تتطلب فهم مصادر التحديث؛ لا تفترض أن كل third-party callback سيحدّث UI تلقائيًا دون integration مناسب.
Rendering Performance و OnPush و Track Identity
استخدم stable identity في @for (...; track item.id) حتى Angular يعيد استخدام DOM nodes بدل إعادة إنشائها. OnPush يقلل checks في ظروف محددة لكنه لا يصلح state mutation غير المنضبطة. قس performance بـ Angular DevTools و browser Performance panel قبل إضافة memoization. تجنب expensive function calls في templates؛ انقل الحساب إلى computed/selector.
Lazy load routes لتقليل initial bundle، راجع bundle budgets، واستعمل defer blocks عندما المحتوى غير critical. لا lazy-load كل component صغيرًا بلا قياس؛ كثرة chunks قد تزيد requests/complexity. راقب hydration/SSR behavior إذا كان مستخدمًا، وتجنب browser-only APIs أثناء server rendering.
Debug Change Detection و Unexpected Renders
عند render غير متوقع، تتبع signal/observable/input/event الذي تسبب فيه، وافحص object identity و mutable updates و template expressions. استخدم Angular DevTools profiler لمعرفة components التي فُحصت ووقت rendering. لا تضف ChangeDetectorRef.detectChanges() كحل سريع قبل فهم lifecycle؛ قد تخفي state flow غير صحيح أو تسبب ExpressionChanged errors.
حافظ على state updates في event handlers/store actions، واجعل computed selectors pure. تجنب effects المتبادلة التي تحدث signals بعضها بعضًا. قس قبل وبعد أي optimization، واختبر أن UI لا تعرض stale state بعد navigation أو async response متأخر.
Routing و Lazy Loading و Preloading
Lazy loading يقلل initial bundle عن طريق تقسيم feature chunks. loadComponent مناسب standalone page، و loadChildren لتحميل route tree. Preloading قد يحمل feature في الخلفية بعد initial navigation لتحسين later navigation، لكن يزيد bandwidth/CPU. اختَر strategy حسب user journey وحجم bundle.
export const routes: Routes = [
{
path: 'admin',
canActivate: [signedInGuard],
loadChildren: () => import('./admin/admin.routes')
.then(m => m.ADMIN_ROUTES)
},
{
path: 'orders',
loadComponent: () => import('./orders/orders-page.component')
.then(m => m.OrdersPageComponent)
}
];Route guard هنا UX gate فقط؛ كل endpoint داخل admin يحتاج server authorization. احذر من lazy chunk الذي يحتوي secrets؛ frontend bundle public حتى لو route مخفية. لا تعتبر code splitting security boundary.
JWT Refresh Interceptor: Single-Flight و Retry Loop Protection
لو عدة requests رجعت 401 في نفس اللحظة، لا تطلق refresh request لكل واحدة. اعمل single-flight refresh observable/promise مشتركة، ثم أعد محاولة requests المناسبة مرة واحدة. امنع interceptor من محاولة refresh على refresh endpoint نفسه، وامنع retry loop إذا refreshed token غير صالح. تعامل مع 403 بشكل مختلف عن 401: user authenticated لكن غير authorized غالبًا لا يحتاج refresh.
Refresh token rotation/reuse detection قرار backend. إذا backend يستخدم HttpOnly cookie، client لا يقرأ refresh token؛ يرسل credentials حسب same-origin/cross-origin setup. لو تستخدم Bearer access token، لا تضف token إلى URLs أو logs. راجع CORS/CSRF policy إذا cookies عبر origins.
// Pseudocode: use one shared in-flight refresh operation.
// 1. If refreshInFlight exists, wait for it.
// 2. Otherwise create refreshInFlight and call the session endpoint.
// 3. On success, update in-memory access state if that is the chosen model.
// 4. Retry each original request at most once.
// 5. On failure, clear session and navigate to login.
// 6. Always clear refreshInFlight in finalize().الكود pseudocode عمدًا لأن التنفيذ يعتمد على cookie vs bearer storage و Angular/RxJS version. لا تنسخ implementation generic من الإنترنت دون اختبار simultaneous 401، expired refresh، logout أثناء refresh، network timeout و request cancellation.
State Management: Local Signals و Signal Store و NgRx
ابدأ بـ component signals للـ local state. لو عدة components في feature تشارك state، استخدم feature service أو store صغير. Signal Store أو NgRx مفيدان عندما تحتاج predictable transitions، effects، entity cache، devtools/time-travel، cross-feature state و team conventions. لا تضف NgRx لكل app؛ boilerplate/learning cost قد يتجاوز القيمة.
افصل server state عن client UI state. Server state تحتاج loading/error/cache/invalidation/refetch/stale handling. Client state مثل selected tab أو modal لا تحتاج server cache. URL state مثل search/sort/page يمكن أن يكون query params. Session/auth state لها security/lifecycle constraints.
Feature State: Component State أم Service أم Store؟
ابدأ component-local state عندما القيمة تخص component واحدًا ولا تحتاج مشاركة. ارفعها إلى parent أو feature service عندما عدة siblings تحتاجها. استخدم store/library عندما توجد state مشتركة واسعة، transitions كثيرة، time-travel/debugging أو team conventions تبرر التكلفة. لا تبدأ NgRx لمجرد أن التطبيق Angular؛ ولا تضع كل state في singleton service.
قسّم state إلى server state (مصدره API ويحتاج caching/refetch/error) و client UI state (selected tab/modal/filter draft) و derived state. لا تخزن derived values مرتين؛ اشتقها بـ computed/selectors. حدد invalidation بعد mutation، optimistic updates rollback، loading/error/empty states، و race behavior عند تبديل route.
Data Flow عملي: API State و UI State و Derived State
صمم feature state كـ union واضحة: `{ status: 'loading' } | { status: 'loaded'; data: T } | { status: 'error'; message: string }` بدل booleans متعددة قد تسمح بحالات متناقضة مثل loading و error و loaded كلها true. derived state مثل total أو filtered list يجب تُحسب من source state، لا تُخزن منفصلة ثم تنسى تحديثها.
type LoadState<T> =
| { status: 'idle' }
| { status: 'loading' }
| { status: 'loaded'; data: T }
| { status: 'error'; message: string };
const state = signal<LoadState<Product[]>>({ status: 'idle' });
const products = computed(() =>
state().status === 'loaded' ? state().data : []
);عند mutation حدد optimistic أو pessimistic update. optimistic update يحتاج rollback عند failure، وقد يتعارض مع server canonical response. عند route change ألغِ/تجاهل stale request. عند logout امسح user-scoped cache/state حتى لا تظهر بيانات مستخدم سابق على نفس الجهاز.
Frontend Error Handling و Telemetry
أنشئ error taxonomy موحدة: validation، unauthorized، forbidden، conflict، throttled، network/offline، server failure، unexpected client bug. UI تعرض message آمنة ومفهومة، وتوفر retry عند معنى، وتحتفظ بال form values عند فشل قابل للتصحيح. لا تعرض stack traces أو raw response body للمستخدم.
Telemetry تحتاج route/component/action context، correlation/trace ID من backend، app version و browser metadata الضروري فقط. اعمل redaction للـ email/token/PII. Error monitoring مثل Application Insights/Sentry يربط frontend error بالـ backend trace عند تمرير trace context؛ لا ترسل كل input أو full URL query لو يحتوي بيانات حساسة.
Error State Pattern: Retry و Empty و Forbidden و Not Found
كل route data view يجب تميز loading، loaded-empty، loaded-with-data، unauthorized/forbidden، not-found، transient failure، و offline. لا تحول كل failure إلى []؛ ذلك يوهم المستخدم أن لا توجد نتائج. اعرض retry فقط عندما العملية قابلة للإعادة بأمان، واحتفظ بال filter/search state عند الرجوع من detail page.
اربط error code من API برسالة localized في frontend، لكن لا تعرض stack trace أو raw server exception. لو 401 يعني session expired، نفذ refresh flow مرة واحدة ثم logout/redirect بشكل منضبط؛ لا تكرر refresh loop. اختبر كل state عبر component tests.
SignalR و SSE Client Integration
SignalR مناسب bidirectional messaging مع hub methods/groups/reconnect، و SSE مناسب server-to-client event stream عبر HTTP. Angular service تملك connection lifecycle، authentication strategy، reconnect backoff، subscriptions و cleanup. component لا تنشئ connection مستقلة لكل view إلا لو ownership فعلاً محلي.
بعد reconnect قد تحتاج resync snapshot لأن events أثناء disconnect ضاعت. استخدم sequence/version أو event ID عند الحاجة. server يتحقق من authorization لكل hub method/group membership، ولا يثق في tenant/user IDs يرسلها client. اعمل rate limiting وحماية من connection exhaustion.
SSR و Hydration و Prerendering
SSR ينفذ rendering على server لإرجاع HTML أولي، ثم hydration تربط client app بالـ DOM الموجود بدل إعادة بنائه بالكامل. Prerender/SSG ينتج HTML وقت build للصفحات المناسبة. اختَر SSR للـ SEO/initial content/perceived performance أو public pages؛ admin dashboards خلف auth قد لا تستفيد بنفس الدرجة.
SSR يغير assumptions: لا تستخدم window, document, localStorage أثناء server render من غير platform guards. لا تعتمد على per-process singleton state لتخزين user data بين requests؛ server process يخدم users متعددين. افصل user-specific data per request، واحذر cache leakage. Hydration mismatch قد ينتج من Date/random values أو DOM mutation خارج Angular.
Incremental hydration/defer blocks تساعد تحميل أجزاء حسب viewport/interaction حسب capabilities/version. قس LCP/INP/CLS و server response time، ولا تعتبر SSR حلًا سحريًا لو backend API بطيئة أو JS bundle ضخم.
SSR و Hydration و Browser-Only APIs
SSR يحسن first contentful rendering ومحركات البحث لبعض التطبيقات، لكنه يضيف server runtime و hydration constraints. لا تنفذ browser-only APIs مثل localStorage/window أثناء server render بلا platform guard. لا تجعل initialization يرسل payment/create requests لأن server و browser قد يكرران render/hydration. استخدم transfer state أو data loading strategy لتجنب duplicate fetch عندما framework يدعم ذلك.
Hydration تتطلب أن HTML الذي ينتجه server يتوافق مع أول client render؛ اختلاف الوقت/random values أو locale أو DOM mutation خارج Angular قد يسبب mismatch. اختبر direct navigation و refresh و slow JS و disabled JS حسب أهداف المنتج. SSR ليس مطلوبًا لكل internal dashboard؛ قارن SEO/first render benefits مع hosting/complexity.
Zoneless و SSR و Hydration: نقاط الفشل الحقيقية
في zoneless change detection لا تعتمد على أن أي async callback سيوقظ rendering تلقائيًا بالطريقة القديمة. اعتمد على notifications التي يفهمها Angular مثل signal updates و template-bound events وواجهات framework المدعومة. اختبر third-party libraries التي تغيّر state خارج Angular؛ قد تحتاج adapter أو explicit notification mechanism. لا تحول التطبيق إلى zoneless قبل وجود tests تغطي async updates.
SSR ينفذ جزءًا من rendering على server، ثم hydration تربط DOM الموجود بالـ client app. تجنب اختلاف markup بين server و browser بسبب الوقت الحالي أو random values أو locale/timezone غير موحد. لا تستخدم window أو localStorage مباشرة أثناء server render؛ اعزل browser-only APIs behind platform-aware services أو after-render hooks المناسبة للإصدار.
اختبر hydration mismatch، duplicate event handling، loading placeholders، direct navigation إلى deep route، refresh، و SEO metadata. لا تجعل SSR يطلب بيانات user-specific بدون auth/session boundary واضح، ولا تضع secrets في HTML serialized state. اختبر caching حتى لا يتشارك مستخدمان HTML مخصصًا لبعضهما.
Micro-frontends: متى تكون مفيدة؟
Micro-frontends تقسّم frontend إلى أجزاء يملكها teams/deployments مستقلة، غالبًا عبر module federation أو web components أو routing integration. هي ليست default architecture لتطبيق صغير. تضيف version compatibility، shared dependencies، runtime integration، duplicated bundles، authentication coordination، CSS isolation و observability complexity.
استخدمها عندما teams مستقلة تحتاج release cadence/ownership واضحًا وحدود domain مستقرة. لا تستخدمها لمجرد أن Angular app كبرت؛ feature modules/lazy routes قد تكفي. قبل القرار، حدد shell ownership، shared design system, routing, auth/session, error boundary, version policy و rollback.
Production Performance Checklist
- Initial bundle size و route chunk sizes و lazy loading.
- LCP/INP/CLS على أجهزة وشبكات ممثلة.
- Track keys و virtual scrolling للقوائم الضخمة عند الحاجة.
- تقليل duplicate HTTP calls و N+1 API requests.
- SSR/hydration mismatch و server rendering cost.
- Memory leaks من subscriptions/connections/timers.
- Error rate و failed navigation و API latency per feature.
- Accessibility keyboard/screen reader و responsive reflow.
ابدأ بقياس user-visible bottleneck قبل micro-optimization. Bundle analysis قد يكشف dependency ضخمة؛ API tracing قد يكشف latency في backend؛ browser performance profile قد يكشف long task في main thread. اربط frontend و backend trace IDs لتشخيص end-to-end.
اختبر فهمك
هل effect أفضل طريقة لحساب total من quantity و price signals؟
هل lazy route أو guard يحمي endpoint؟
لماذا single-flight refresh مهم؟
متى تختار Signal Store/NgRx؟
ما الخطر الخاص بـ SSR singleton state؟
هل Micro-frontends تحل كل مشاكل frontend الكبير؟
Signals و RxJS: متى تختار كل واحدة؟
Signal مناسبة لقراءة قيمة حالية متزامنة داخل UI، مع dependency tracking وتحديثات محسوبة. Observable مناسبة لتدفق زمني: HTTP events و WebSocket و user input و cancellation و composition. لا تحول كل Observable إلى Signal تلقائيًا ولا تجعل كل state stream Subject. اختَر abstraction وفق طبيعة المصدر والمستهلك.
computed مشتقة pure ولا ينبغي أن تنفذ side effects. effect للربط مع API imperative مثل localStorage أو analytics، وليس بديلًا عن computed. تجنب كتابة signal من effect دون ضرورة لأن ذلك قد ينشئ feedback loops. عند interop، استخدم APIs الرسمية مثل toSignal/toObservable مع lifecycle owner واضح، وتحقق من initial value و error/completion semantics.
Signals مقابل RxJS: متى تستخدم كل واحد؟
Signal مناسب لقيمة حالية synchronous داخل component/state، مع dependency tracking و computed derivation. RxJS مناسب لتدفقات زمنية: HTTP events، WebSocket، user input، retries، cancellation، و combining streams. لا تحوّل كل Observable إلى Signal بلا داعٍ، ولا تستخدم RxJS pipeline كاملة لمجرد اشتقاق قيمة synchronous.
export class CartState {
readonly items = signal<CartItem[]>([]);
readonly subtotal = computed(() =>
this.items().reduce((sum, item) => sum + item.price * item.quantity, 0)
);
readonly hasItems = computed(() => this.items().length > 0);
add(item: CartItem) {
this.items.update(current => [...current, item]);
}
}Signals لا تجعل state immutable تلقائيًا؛ لا تعدل array/object داخليًا in place ثم تتوقع notification. استخدم set/update مع references جديدة. في interop استخدم toSignal أو toObservable وفق lifecycle، وراجع initial value/error behavior. حافظ على مصدر حقيقة واحد لتجنب state duplicated بين Subject و Signal.
Component Lifecycle و DestroyRef و Cleanup
Component lifecycle hooks ترتبط بإنشاء/تحديث/تدمير view. استخدم DestroyRef أو takeUntilDestroyed لتنظيف subscriptions والـ event listeners والـ timers. ngOnChanges مناسب للتعامل مع input changes، لكن تجنب استخدام lifecycle hook كبديل عن state derivation. لا تنشئ side effects غير قابلة للتكرار داخل computed/signal derivations.
في SSR/hydration، لا تفترض وجود window أو document أثناء server rendering. استخدم platform guards أو injected abstractions، وأجّل browser-only code إلى lifecycle مناسب. تجنب DOM manipulation اليدوي عندما template/directives تكفي. اختبر navigation بعيدًا عن component ثم العودة إليه للتأكد أن subscriptions لم تتراكم.
Modern Angular Architecture Checklist
استخدم standalone/lazy routes بحدود feature واضحة، Signals للقيم الحالية المشتقة، RxJS للـ async streams، OnPush/track identity مع state immutable، DestroyRef للتنظيف، typed reactive forms، و API services للـ network boundaries. SSR يحتاج browser guards و hydration-safe rendering. لا تضف state library أو abstraction إلا عندما حجم المشاركة والتعقيد يبررها.
Modern Angular Final Review
راجع أن signals لا تتعرض mutation داخلية، computed لا تنفذ side effects، effects لها cleanup، RxJS streams لها subscription owner، lazy routes لها error/loading behavior، forms typed ومتحقق منها على server، و SSR لا يستخدم browser globals أثناء render. راقب OnPush و track identity، وامنع duplicate state sources. هذا التكامل أهم من استخدام أحدث API منفردة.
Modernize Angular Gradually
في تطبيق قائم، لا تعِد كتابة كل architecture دفعة واحدة. ابدأ بتحديث Angular وفق supported migration path، أصلح deprecations، فعّل strict template/type checks، ثم انقل feature واحدة إلى standalone/lazy route. أدخل signals في local derived state مع إبقاء RxJS streams التي تحتاج concurrency/cancellation. قس bundle/performance قبل وبعد، واكتب regression tests.
راجع third-party library compatibility، SSR/hydration، test runner، build tooling، و browser support. لا تخلط framework migration مع redesign كبير في نفس release؛ افصل التغييرات حتى يسهل تحديد مصدر regression والرجوع عنه.
Version Compatibility و Migration Safety
ثبت Angular CLI و TypeScript و Node versions المتوافقة وفق Angular compatibility matrix. لا تحدث TypeScript وحدها إلى latest إذا framework لا يدعمها. نفذ migrations الرسمية، اقرأ breaking changes، وشغّل unit/e2e/build في كل خطوة. lockfile و CI runtime pinning يمنعان “يعمل عندي” بسبب اختلاف البيئة.
Angular Version Compatibility و Migration Strategy
Angular ecosystem سريع التطور؛ لذلك لا تخلط snippets من Angular 14 و17 و20+ في تطبيق واحد دون معرفة ما تغيّر. قبل أي upgrade سجّل Angular CLI و framework و TypeScript و RxJS و Node versions من ng version وملفات package/lock، ثم راجع compatibility matrix الرسمية. لا تفترض أن أحدث TypeScript أو Node مدعوم تلقائيًا مع إصدار Angular الحالي.
ng version
node --version
npm --version
npm ls @angular/core @angular/cli typescript rxjs
npm outdatedخطة ترقية آمنة: (1) ثبّت baseline و CI green، (2) اقرأ breaking changes و deprecations لكل major، (3) حدّث major-by-major باستخدام Angular Update Guide/CLI migrations، (4) شغّل lint/typecheck/unit/e2e بعد كل خطوة، (5) راجع third-party libraries والـ builders، (6) افحص bundle/runtime/SSR، (7) انشر canary أو staging ثم راقب. لا تتجاوز majors متعددة لمجرد اختصار الوقت إلا إذا كانت أداة الترقية والـ guide تدعم المسار بوضوح.
افصل migration concerns: standalone adoption، control-flow syntax، signals، zoneless، SSR/hydration، و new forms APIs ليست مهمة واحدة. اعمل تغييرات صغيرة قابلة للرجوع. عند ظهور deprecated API، لا تستبدله آليًا قبل فهم semantic difference؛ خاصة في forms و router guards و RxJS interop و render lifecycle.
اكتب ADR قصيرًا لأي قرار يغيّر rendering أو state strategy: ما المشكلة؟ ما البديل؟ ما أثره على testing/performance/accessibility؟ وما rollback؟ واحتفظ بـ lockfile committed حتى تكون بيئة CI reproducible.
Accessibility مع Modern Components
اختبر focus management و keyboard semantics في dialogs و menus و custom controls، ولا تعتمد على visual state فقط. استخدم native elements متى أمكن، واجعل accessible name و disabled state و error announcements جزءًا من component contract.
المراجع والقراءة الإضافية
الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)
خريطة التغطية: 24 عنصر من الـ Roadmap ومكان شرحه في الدرس
خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.