هنطلع من الدرس بإيه؟
هتقدر تبني frontend بيتكلم مع API محمي بـ JWT من غير ثغرات شائعة، وتشرح ليه الـ frontend authorization مش أمان، وتكتب اختبارات للـ logic الحساس.
- تصمم token handling وتشرح trade-offs التخزين (memory / sessionStorage / HttpOnly cookie).
- تنفذ refresh واحد مشترك (single-flight) لما كذا request يفشلوا مع بعض.
- تتجنب XSS وتفهم CSP و CSRF و CORS ودور كل واحد.
- تقيس وتحسن الأداء (lazy routes، OnPush، debounce، trackBy).
المتطلبات: Angular وModern Angular وJWT. المشروع الكامل: EXAMPLES/MajorProjects/P4-Angular-FullStack.
ابدأ بمثال شغال: ترتيب تنفيذ الـ async
أي bug في interceptor أو token refresh أصله فهم غلط لترتيب التنفيذ. الكود ده بيطبع الترتيب الحقيقي (اتنفذ بـ Node):
const log = [];
log.push('1 sync start');
setTimeout(() => log.push('5 macrotask (setTimeout 0)'), 0);
Promise.resolve().then(() => log.push('3 microtask (promise.then)'));
queueMicrotask(() => log.push('4 microtask (queueMicrotask)'));
(async () => { log.push('2 sync inside async fn (before first await)'); await null; log.push('3b after await (microtask)'); })();
log.push('2b sync end');
setTimeout(() => { console.log(log.join('\n')); }, 10);1 sync start
2 sync inside async fn (before first await)
2b sync end
3 microtask (promise.then)
4 microtask (queueMicrotask)
3b after await (microtask)
5 macrotask (setTimeout 0)القاعدة: الكود المتزامن الأول، بعدين كل الـ microtasks (promises/await)، وبعدين الـ macrotasks (setTimeout). وده بيفسر ليه await بيرجّعك بعد الكود المتزامن اللي بعده حتى لو الـ promise جاهزة.
Token handling: اختار وانت فاهم الـ trade-off
| مكان التخزين | المخاطر | ملاحظات |
|---|---|---|
localStorage | أي XSS يقرأه ويسرق الجلسة | أسهل لكن الأضعف أمنيًا لو فيه أي ثغرة XSS |
| Memory (متغير/signal) | بيضيع عند reload، XSS لسه بيقدر يستعمله أثناء الجلسة لكن مش يسرقه بسهولة بعد الإغلاق | مناسب للـ access token القصير |
sessionStorage | زي localStorage لكن بيموت مع التبويب | حل وسط لمشروع التعلم (المشروع بيستخدمه للـ refresh) |
| HttpOnly + Secure + SameSite cookie | JS مش بيقراه (يحمي من سرقة XSS) لكن يحتاج حماية CSRF | الأقوى عادةً للـ refresh token، ويتطلب تعديل الـ API ليستخدم cookies |
مفيش مكان «آمن 100%»: XSS بيخلّي المهاجم ينفذ طلبات باسم المستخدم حتى لو ما قدرش يسرق التوكن. الدفاع الحقيقي هو منع الـ XSS نفسه (escaping + CSP + dependencies نظيفة).
Refresh واحد مشترك (single-flight)
لو الـ access token انتهى و5 requests اتبعتوا مع بعض، كلهم هياخدوا 401. لو كل واحد حاول يعمل refresh، والـ API بتعمل rotation (كل refresh token بيشتغل مرة واحدة)، فالأربعة التانيين هيستخدموا token اتحرق، والـ API هتعتبرها سرقة وتقفل الجلسة كلها. الحل: وعد واحد مشترك. المثال ده نسخة JavaScript من نفس الكود اللي في المشروع، مع «سيرفر» محاكي بيطبق قاعدة الـ rotation:
function singleFlight(fn) {
let inFlight = null;
return () => (inFlight ??= fn().finally(() => { inFlight = null; }));
}
// "Server": each refresh token works once; reuse revokes the whole session (like Project 3's API).
function makeServer() {
let current = 'rt-0', counter = 0, revoked = false;
return {
async refresh(token) {
await new Promise(r => setTimeout(r, 5));
if (revoked || token !== current) { revoked = true; throw new Error('refresh token reuse -> session revoked'); }
current = `rt-${++counter}`; return current;
},
get revoked() { return revoked; },
};
}
async function scenario(useSingleFlight) {
const server = makeServer();
let token = 'rt-0';
const doRefresh = async () => { token = await server.refresh(token); return token; };
const refresh = useSingleFlight ? singleFlight(doRefresh) : doRefresh;
const results = await Promise.allSettled(Array.from({ length: 5 }, () => refresh()));
return { ok: results.filter(r => r.status === 'fulfilled').length, failed: results.filter(r => r.status === 'rejected').length, sessionRevoked: server.revoked };
}
console.log('without single-flight:', JSON.stringify(await scenario(false)));
console.log('with single-flight :', JSON.stringify(await scenario(true)));without single-flight: {"ok":1,"failed":4,"sessionRevoked":true}
with single-flight : {"ok":5,"failed":0,"sessionRevoked":false}الفرق واضح: من غير single-flight الجلسة اتقفلت وفشلت طلبات؛ معاه refresh واحد وكل الطلبات نجحت. نفس الفكرة بتتطبق في الـ interceptor (auth.refresh() في المشروع).
XSS و CSRF و CORS و CSP: كل واحد بيحمي من إيه؟
- XSS: تنفيذ سكريبت المهاجم في صفحتك. Angular بيعمل escaping تلقائي للـ interpolation
{{ }}. الخطر في[innerHTML]معbypassSecurityTrustHtmlأو بناء DOM يدويًا بـinnerHTML، وفي الـ dependencies المصابة. - CSP: header بيحدد مصادر السكريبت المسموحة؛ طبقة دفاع إضافية لو حصل XSS (لا يحل محل الـ escaping).
- CSRF: استغلال إن المتصفح بيبعت cookies تلقائيًا. بيهم لو الـ auth بـ cookies. مع
Authorization: Bearerيدوي مش بيتبعت تلقائيًا فالخطر أقل، لكن لو انتقلت لـ cookies لازم SameSite و anti-forgery token. - CORS: سياسة المتصفح بتحدد مين يقرأ ردود API من origin مختلف. مش آلية أمان للـ API نفسه (curl ما بيتأثرش). في ASP.NET Core سمّي origins صراحة؛ ممنوع
AllowAnyOriginمع credentials. الأفضل في الإنتاج same-origin عبر reverse proxy (زي P5) فمفيش CORS أصلاً. - Authorization على الـ client:
*ngIfو guards بيخفوا واجهة بس. أي مستخدم يقدر يستدعي الـ API مباشرة، فالـ backend لازم يفرض الصلاحيات (401/403).
مثال عملي على الـ XSS: الكود ده بيوضح ليه الـ escaping لازم (بدون DOM، بنحاكي الـ escaping):
const escapeHtml = s => s.replace(/[&<>"']/g, c => ({ '&': '&', '<': '<', '>': '>', '"': '"', "'": ''' }[c]));
const evil = '<img src=x onerror="alert(document.cookie)">';
console.log('raw into HTML :', `<p>Hello ${evil}</p>`);
console.log('escaped into HTML:', `<p>Hello ${escapeHtml(evil)}</p>`);raw into HTML : <p>Hello <img src=x onerror="alert(document.cookie)"></p>
escaped into HTML: <p>Hello <img src=x onerror="alert(document.cookie)"></p>النسخة الأولى فيها tag حقيقي هينفذ كود؛ التانية بقت نص عادي. Angular بيعمل التاني تلقائيًا لما تستخدم {{ }}.
الاختبارات والأداء
اختبر المنطق الحساس كـ pure functions: decode/expiry للـ JWT و single-flight في المشروع متفصولين عن Angular واتختبروا بـ tsc --strict و5 node:test (Tested). اختبارات Angular الحقيقية (TestBed و HttpTestingController) موجودة في auth.service.spec.ts لكنها Not Executed هنا (مفيش @angular/* packages). الهرم: كتير unit للـ logic، شوية component tests للـ forms، وعدد قليل من e2e (Playwright) للـ flows الحرجة (login → refresh → logout).
الأداء (قِس قبل ما تحسّن): lazy-loaded routes (loadComponent) لتقليل الـ bundle الأولي، ChangeDetectionStrategy.OnPush أو signals لتقليل الفحص، @for ... track لتفادي إعادة بناء القوائم، debounce للبحث، pagination من الـ API بدل تحميل الكل، وتحليل الـ bundle بـ source-map-explorer أو الأداة المدمجة. ما تفترضش إن تحسين معين مفيد: افتح DevTools Performance/Network وقِس.
OAuth 2.0 Authorization Code + PKCE من Angular: الرحلة كاملة
Angular app ما تقدرش تحفظ client secret (أي كود في المتصفح مقروء). عشان كده الـ SPA بتستخدم Authorization Code + PKCE: بتثبت إنها نفس اللي بدأت الـ login من غير secret ثابت. الـ Implicit flow القديم (token في الـ URL) اتشال من التوصيات الحالية (OAuth 2.0 Security BCP).
ليه PKCE بيحمي؟ لو مهاجم اعترض الـ code في الـ redirect (تطبيق خبيث على الموبايل أو log)، مش هيقدر يبدّله بـ token من غير الـ code_verifier اللي ما خرجش من التطبيق. و state بيمنع CSRF على الـ callback. عمليًا ما تكتبش الـ flow بإيدك: استخدم مكتبة معتمدة (مثلًا angular-auth-oidc-client أو MSAL Angular مع Entra ID) وركّز على الإعدادات.
| النمط | الـ tokens فين؟ | متى |
|---|---|---|
| SPA + PKCE (tokens في الذاكرة) | memory في المتصفح، refresh rotation | APIs على domains مختلفة، فريق صغير |
| BFF (Backend-for-Frontend) | على السيرفر؛ المتصفح عنده HttpOnly cookie بس | بيانات حساسة، أعلى أمان ضد XSS — التوصية المتزايدة للتطبيقات الجديدة |
الربط: نفس الـ validation اللي في JWT على الـ API، والـ BFF ممكن يتعمل بـ ASP.NET Core + YARP.
Angular Testing بالتفصيل: TestBed و Vitest و HttpTestingController و Harnesses
من Angular 21، المشاريع الجديدة بتستخدم Vitest كـ test runner افتراضي عبر builder اسمه @angular/build:unit-test (Karma/Jasmine لسه مدعومين للمشاريع القديمة وفيه دليل migration رسمي). Vitest بيشغّل الاختبارات في Node مع DOM emulation (jsdom) — أسرع بكتير، ومع خيار browser mode لو احتجت متصفح حقيقي.
ng new shop-web # Vitest + jsdom configured by default (Angular 21+)
ng test # runs the unit-test builder; --watch during development
# existing Karma project: follow angular.dev "Migrating to Vitest" (schematic + config changes)1) Service مع HttpClient: HttpTestingController
import { TestBed } from '@angular/core/testing';
import { provideHttpClient } from '@angular/common/http';
import { HttpTestingController, provideHttpClientTesting } from '@angular/common/http/testing';
import { OrdersService } from './orders.service';
describe('OrdersService', () => {
let service: OrdersService;
let http: HttpTestingController;
beforeEach(() => {
TestBed.configureTestingModule({
providers: [provideHttpClient(), provideHttpClientTesting(), OrdersService], // order matters: testing backend last
});
service = TestBed.inject(OrdersService);
http = TestBed.inject(HttpTestingController);
});
afterEach(() => http.verify()); // fails the test if an unexpected request was made
it('loads a page of orders with the right query', async () => {
const p = service.list({ page: 2, size: 20 }); // returns a Promise via firstValueFrom
const req = http.expectOne(r => r.url === '/api/orders' && r.params.get('page') === '2');
expect(req.request.method).toBe('GET');
req.flush({ items: [{ id: 'o1', total: 120 }], total: 41 });
expect((await p).items).toHaveLength(1);
});
it('maps a 409 to a domain error', async () => {
const p = service.cancel('o1');
http.expectOne('/api/orders/o1/cancel').flush(
{ title: 'Already shipped' }, { status: 409, statusText: 'Conflict' });
await expect(p).rejects.toMatchObject({ kind: 'conflict' });
});
});2) Interceptor: اختبره عبر HttpClient الحقيقي
TestBed.configureTestingModule({
providers: [
provideHttpClient(withInterceptors([authInterceptor])),
provideHttpClientTesting(),
{ provide: TokenStore, useValue: { access: () => 'abc' } },
],
});
const client = TestBed.inject(HttpClient);
client.get('/api/me').subscribe();
const req = TestBed.inject(HttpTestingController).expectOne('/api/me');
expect(req.request.headers.get('Authorization')).toBe('Bearer abc');3) Component بـ signals
@Component({ selector: 'app-cart-summary', template: `<p data-testid="total">{{ total() }}</p>` })
class CartSummary { items = input<{ price: number; qty: number }[]>([]);
total = computed(() => this.items().reduce((s, i) => s + i.price * i.qty, 0)); }
it('recomputes the total when the input signal changes', async () => {
const fixture = TestBed.createComponent(CartSummary);
fixture.componentRef.setInput('items', [{ price: 10, qty: 2 }]);
await fixture.whenStable(); // works with zoneless change detection too
expect(fixture.nativeElement.querySelector('[data-testid=total]').textContent).toBe('20');
fixture.componentRef.setInput('items', [{ price: 10, qty: 3 }]);
await fixture.whenStable();
expect(fixture.nativeElement.querySelector('[data-testid=total]').textContent).toBe('30');
});
// Pure signal logic needs no DOM: create the signal/computed inside TestBed.runInInjectionContext and assert values.4) Component Harnesses (Angular CDK)
بدل ما الاختبار يعتمد على CSS selectors داخلية لـ Angular Material (اللي بتتغير بين النسخ)، الـ harness بيديك API ثابت: «اضغط الزرار ده»، «اختار option». الاختبار بيقرأ زي سلوك المستخدم ومش بيتكسر مع تغيير الـ DOM.
import { TestbedHarnessEnvironment } from '@angular/cdk/testing/testbed';
import { MatSelectHarness } from '@angular/material/select/testing';
import { MatButtonHarness } from '@angular/material/button/testing';
const fixture = TestBed.createComponent(OrderFilterComponent);
const loader = TestbedHarnessEnvironment.loader(fixture);
const status = await loader.getHarness(MatSelectHarness.with({ selector: '[formControlName=status]' }));
await status.open();
await status.clickOptions({ text: 'Shipped' });
await (await loader.getHarness(MatButtonHarness.with({ text: 'Apply' }))).click();
expect(fixture.componentInstance.applied()).toEqual({ status: 'shipped' });| المستوى | الأداة | يختبر إيه | العدد |
|---|---|---|---|
| Pure logic | Vitest بدون TestBed | mappers، validators، reducers | كتير |
| Service/Interceptor | TestBed + HttpTestingController | URLs، headers، error mapping | متوسط |
| Component | TestBed + harnesses/Testing Library | rendering، تفاعل، forms | متوسط |
| E2E | Playwright | login → flow حرج → logout مع API حقيقي أو mocked | قليل |
نسيان http.verify() فطلبات زيادة بتعدّي؛ اختبار تفاصيل implementation (private methods، أسماء CSS داخلية) بدل السلوك؛ setTimeout في الاختبار بدل whenStable/fake timers (vi.useFakeTimers())؛ mock لكل حاجة لحد ما الاختبار مش بيختبر غير الـ mocks.
الأداء بالأرقام: Core Web Vitals و @defer و budgets والصور
| المقياس | بيقيس | الهدف «جيد» (Google) | أشهر أسباب السوء في Angular |
|---|---|---|---|
| LCP | أكبر عنصر مرئي ظهر إمتى | ≤ 2.5s | bundle أولي ضخم، صورة hero مش prioritized، API بطيء قبل الـ render |
| INP | سرعة الاستجابة للتفاعل | ≤ 200ms | حسابات تقيلة في الـ main thread، change detection على شجرة كبيرة |
| CLS | قفزات الـ layout | ≤ 0.1 | صور من غير أبعاد، محتوى بيتحمّل فوق المحتوى الموجود |
<!-- hero image: LCP candidate, fetched with high priority; width/height prevent layout shift -->
<img ngSrc="/assets/hero.webp" width="1200" height="600" priority alt="Dashboard overview" />
<!-- heavy chart library loaded only when the section scrolls into view -->
@defer (on viewport) {
<app-sales-chart [data]="sales()" />
} @placeholder (minimum 300ms) {
<div class="chart-skeleton" aria-hidden="true"></div>
} @loading (after 150ms) {
<p>Loading chart…</p>
} @error {
<p>Chart unavailable.</p>
}{
"budgets": [
{ "type": "initial", "maximumWarning": "500kB", "maximumError": "1MB" },
{ "type": "anyComponentStyle", "maximumWarning": "4kB", "maximumError": "8kB" }
]
}الـ loop الصح: قِس (Lighthouse + بيانات حقيقية من المستخدمين عبر web-vitals library إلى الـ telemetry) ← حدّد أكبر سبب ← غيّر حاجة واحدة ← قِس تاني ← اقفلها بـ budget أو test. نفس منهج الـ backend في ASP.NET Core Performance.
Knowledge check
ليه SPA ما تستخدمش client secret في الـ OAuth flow؟
اختبار service نجح رغم إن الكود بيبعت طلب HTTP زيادة مش متوقع. إيه الناقص غالبًا؟
LCP سيء والسبب صورة الـ hero. أول إصلاح؟
E2E بـ Playwright: الـ flows الحرجة بس
import { test, expect } from '@playwright/test';
test('session survives access-token expiry via refresh', async ({ page }) => {
await page.goto('/login');
await page.getByLabel('Email').fill('member@demo.test');
await page.getByLabel('Password').fill(process.env.E2E_PASSWORD!); // test account from the seed, never a real one
await page.getByRole('button', { name: 'Sign in' }).click();
await expect(page.getByRole('heading', { name: 'Documents' })).toBeVisible();
await page.clock.fastForward('16:00'); // past the 15-minute access token lifetime
await page.getByRole('link', { name: 'Billing' }).click();
await expect(page.getByText('Current plan')).toBeVisible(); // refresh happened silently
});اختار 5–10 flows بس (login/refresh/logout، أهم مهمة للمستخدم، الدفع/الـ upgrade، صلاحيات admin)، واستخدم locators بالـ role والـ label (نفس اللي بيستخدمه screen reader) — بتخلي الاختبار أثبت وبتختبر الـ accessibility ضمنيًا.
أخطاء شائعة
- إرسال الـ token لأي URL (حتى مواقع خارجية): تحقق إن الـ URL بتاع الـ API قبل إضافة الـ header.
- interceptor بيعمل refresh لطلب
/auth/refreshنفسه (loop لا نهائي). - الاعتماد على guard كأمان.
- تخزين بيانات حساسة في localStorage.
- استخدام
bypassSecurityTrust*مع input من المستخدم. - تحميل كل البيانات ثم فلترتها في المتصفح.
- تجاهل حالات loading و error و empty.
خمس تمارين محلولة
role المقروء من الـ JWT في المتصفح؟">
الحل: الـ JWT محتواه مقروء (base64) ومش مشفّر، والـ client ممكن يتعدّل. نقرأ الـ role للـ UX فقط (إخفاء زر). السيرفر بيتحقق من التوقيع ويفرض الـ policies في كل طلب.
2 (Easy): إيه الفرق بين CORS error وخطأ 401/403؟
الحل: CORS error بيحصل في المتصفح لما الـ origin مش مسموح (الطلب غالبًا وصل للسيرفر لكن المتصفح بيمنع قراءة الرد أو الـ preflight فشل). 401/403 رد فعلي من الـ API عن الهوية/الصلاحية. شوف تبويب Network: لو مفيش status code واضح وفيه رسالة CORS يبقى المشكلة في الـ CORS policy.
3 (Intermediate): اكتب interceptor منطقه: لو 401 اعمل refresh مرة واحدة ثم أعد المحاولة. إيه الحالات الحدية؟
الحل: (1) استثني طلبات /auth/*. (2) refresh مشترك (single-flight). (3) لو الـ refresh فشل: امسح الجلسة ووجّه لـ login ولا تعيد المحاولة. (4) أعد المحاولة مرة واحدة بس (ما تعملش loop). (5) ما تضيفش الـ token لـ origins تانية. الكود المرجعي في auth.interceptor.ts.
4 (Intermediate): الـ search بيبعت request مع كل حرف. حسّنه
الحل: debounce (300ms) + إلغاء الطلب القديم (switchMap في RxJS) + تجاهل النصوص الأقصر من حد أدنى لو مناسب. في المشروع استخدمنا setTimeout للتبسيط؛ النسخة الأحسن: valueChanges.pipe(debounceTime(300), distinctUntilChanged(), switchMap(...)).
5 (Challenging): صمم الانتقال لـ HttpOnly cookie للـ refresh token. إيه اللي يتغير في الـ API والـ frontend؟
الحل: الـ API بتحط الـ refresh token في cookie (HttpOnly; Secure; SameSite=Strict; Path=/api/auth) ومش في الـ body، و /refresh بتقراه من الـ cookie. الـ frontend بيبعت withCredentials: true ومبيشوفش الـ token أبدًا. لازم حماية CSRF لـ endpoints اللي بتعتمد على cookie (SameSite + anti-forgery header مخصص). CORS لازم يسمح بالـ credentials لـ origin محدد؛ الأفضل same-origin عبر proxy. اختبر: logout بيمسح الـ cookie، و reuse detection لسه شغال.
Mini Project: أضف Role-based UI واختبارًا للـ interceptor
في مشروع P4: (1) أضف صفحة /admin محمية بـ roleGuard('Admin')، (2) اكتب اختبار interceptor بـ HttpTestingController: طلب → 401 → refresh واحد فقط حتى مع 3 طلبات متزامنة → إعادة المحاولة بالـ token الجديد، (3) اختبر إن الـ interceptor ما بيضيفش Authorization لـ URL خارجي. معيار النجاح: الاختبارات خضراء، وصفحة admin بتتحجب بـ 403 من الـ API حتى لو اتخطى المستخدم الـ guard.
أسئلة إنترفيو
فين تخزن الـ JWT في SPA؟
ليه الـ guard مش أمان؟
إزاي Angular بيحمي من XSS؟
bypassSecurityTrust* أو تتعامل مع DOM مباشرة.يعني إيه preflight request؟
ليه single-flight مهم مع refresh rotation؟
(أصعب) ليه بنفضل Microtask على setTimeout في ترتيب التنفيذ، وإيه تأثير ده على الـ Promise chains؟
المراجع والقراءة الإضافية
الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)
التوثيق الرسمي — Official documentation
خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.