كيف تختبر مكونات وخدمات Angular؟

Question

Accepted Answer

يأتي Angular مع إعداد اختبار كامل (Jasmine + Karma بشكل افتراضي، لكن العديد من الفرق تستخدم Jest). يوفر **`TestBed`** لتكوين وحدة اختبار وإنشاء مثيل من المكونات/الخدمات مع تبعياتها — مستفيداً من DI لحقن الكائنات الوهمية.

## اختبار خدمة (الأبسط)

```ts
describe("UserService", () => {
  let service: UserService;
  let httpMock: HttpTestingController;

beforeEach(() => {
    TestBed.configureTestingModule({
      imports: [HttpClientTestingModule], // mock HttpClient
      providers: [UserService],
    });
    service = TestBed.inject(UserService);
    httpMock = TestBed.inject(HttpTestingController);
  });

it("fetches users", () => {
    service.getUsers().subscribe(users => expect(users.length).toBe(2));
    const req = httpMock.expectOne("/api/users"); // assert the request was made
    req.flush([{ id: 1 }, { id: 2 }]);             // provide a fake response
  });
});
```

`HttpClientTestingModule` + `HttpTestingController` تتيح لك التأكيد من الطلبات وتوفير استجابات وهمية دون الوصول إلى خادم حقيقي.

## اختبار مكون

```ts
describe("CounterComponent", () => {
  let fixture: ComponentFixture<CounterComponent>;
  let component: CounterComponent;

beforeEach(() => {
    TestBed.configureTestingModule({ imports: [CounterComponent] }); // standalone
    fixture = TestBed.createComponent(CounterComponent);
    component = fixture.componentInstance;
    fixture.detectChanges(); // trigger initial change detection
  });

it("increments on click", () => {
    const button = fixture.nativeElement.querySelector("button");
    button.click();
    fixture.detectChanges();                     // update the view
    expect(component.count).toBe(1);
    expect(button.textContent).toContain("1");   // assert the rendered DOM
  });
});
```

يعطيك `ComponentFixture` الوصول إلى مثيل المكون **وأيضاً** DOM المعروض؛ يجب عليك استدعاء `fixture.detectChanges()` لتشغيل كشف التغييرات بعد التفاعلات.

## محاكاة التبعيات عبر DI

```ts
TestBed.configureTestingModule({
  providers: [{ provide: AuthService, useValue: mockAuthService }], // inject a fake
});
```

يجعل DI في Angular محاكاة التبعيات أمراً تافهاً — وفر تطبيقاً وهمياً لأي تبعية.

## الاختبار غير المتزامن

```ts
it("loads async", fakeAsync(() => {
  component.load();
  tick();                  // simulate passage of time / flush microtasks
  fixture.detectChanges();
  expect(component.data).toBeDefined();
}));
```

`fakeAsync`/`tick` (أو `waitForAsync`) تتحكم في توقيت غير المتزامن بشكل حتمي.

## مستويات الاختبار

```text
Unit:        services, pipes, isolated component logic (fast, most numerous)
Integration: component + template + child components via TestBed
E2E:         full user flows (Cypress, Playwright) — separate from unit tests
```

## لماذا هذا مهم

الاختبار هو أولوية من الدرجة الأولى في Angular، وتوفر معمارية DI تجعله قابلاً للاختبار بشكل خاص — فأنت تحقن كائنات وهمية لأي تبعية.

معرفة `TestBed` (التكوين + الحقن)، `ComponentFixture` (المثيل + DOM + `detectChanges`)، `HttpClientTestingModule` للـ HTTP، ومساعدات غير المتزامن (`fakeAsync`/`tick`) توفر ما يلزم لكتابة اختبارات وحدة وتكامل موثوقة — وهو أمر حتمي للتطبيقات الكبيرة طويلة الأجل التي بُني Angular من أجلها.