كيف تختبر تطبيقات NestJS؟

Question

Accepted Answer

يوفر NestJS **أداة اختبار مدمجة (`@nestjs/testing`)** متكاملة مع Jest، و**معمارية حقن التبعيات تجعل الاختبار نظيفًا بشكل خاص** — تقوم بإنشاء وحدة اختبار وحقن النماذج الوهمية للتبعيات. تنقسم الاختبارات إلى اختبارات الوحدة (معزولة) واختبارات end-to-end (التطبيق الكامل).

## اختبار الخدمة (مع التبعيات الوهمية)

```ts
import { Test } from "@nestjs/testing";

describe("UsersService", () => {
  let service: UsersService;
  let mockRepo = { find: jest.fn(), save: jest.fn() };

beforeEach(async () => {
    const module = await Test.createTestingModule({
      providers: [
        UsersService,
        // inject a MOCK for the repository — no real database needed
        { provide: getRepositoryToken(User), useValue: mockRepo },
      ],
    }).compile();

service = module.get<UsersService>(UsersService);
  });

it("returns all users", async () => {
    mockRepo.find.mockResolvedValue([{ id: 1, name: "Ann" }]);
    const result = await service.findAll();
    expect(result).toHaveLength(1);
    expect(mockRepo.find).toHaveBeenCalled();
  });
});
```

الميزة الرئيسية: معمارية DI في NestJS تتيح لك **استبدال التبعيات الحقيقية بنماذج وهمية** عبر موفري وحدة الاختبار — لذا تختبر الخدمة بشكل معزول، دون قاعدة بيانات حقيقية أو خدمات خارجية.

## محاكاة التبعيات بسهولة

```ts
// provide a fake for ANY dependency by its token
{ provide: EmailService, useValue: { send: jest.fn() } }
{ provide: ConfigService, useValue: { get: () => "test-value" } }
```

بما أن الفئات لا تقوم ببناء تبعياتها (DI يفعل ذلك)، فإن استبدال النماذج الوهمية أمر بسيط — أساس الاختبارات النظيفة.

## اختبار end-to-end — التطبيق الكامل عبر HTTP

```ts
import * as request from "supertest";

describe("Users (e2e)", () => {
  let app: INestApplication;

beforeAll(async () => {
    const module = await Test.createTestingModule({
      imports: [AppModule],        // the whole app
    }).compile();
    app = module.createNestApplication();
    await app.init();
  });

it("GET /users", () => {
    return request(app.getHttpServer())   // make a real HTTP request
      .get("/users")
      .expect(200)
      .expect(res => expect(res.body).toBeInstanceOf(Array));
  });

afterAll(async () => await app.close());
});
```

**اختبارات E2E** تقوم بتحميل التطبيق الكامل وتقديم طلبات HTTP حقيقية (عبر `supertest`)، للتحقق من أن التدفق الكامل (التوجيه → الحراس → الأنابيب → المعالج → الاستجابة) يعمل معًا.

## استراتيجية الاختبار

```text
Unit tests  → services, guards, pipes in isolation (mock dependencies) — fast, numerous
Integration → a controller + its real service together via the testing module
E2E tests   → full app over HTTP (supertest) — verify real request flows, fewer
Use a TEST database (or mocks) for e2e; override providers for external services.
```

## لماذا يهم

الاختبار ضروري للتطبيقات الموثوقة، ومعمارية NestJS تجعله نظيفًا بشكل ملحوظ — فهم كيفية الاختبار مهم لكل من جودة الكود والأداة مصممة بوضوح للقابلية للاختبار.

الرؤية المركزية هي أن **حقن التبعيات يجعل محاكاة النماذج الوهمية بسيطة**: بما أن الفئات تصرح بتبعياتها و DI يوفرها، فإن وحدة `@nestjs/testing` تتيح لك استبدال أي تبعية (مستودعات قاعدة البيانات، الخدمات الخارجية، الإعدادات) بنموذج وهمي من خلال رمزها، مما يتيح **اختبارات وحدة** سريعة ومعزولة لخدمات والحراس والأنابيب دون بنية أساسية حقيقية.

هذه القابلية للاختبار هي السبب الرئيسي لقيمة الأطر القائمة على DI مثل NestJS.
obتكمل اختبارات الوحدة، **اختبارات e2e** (تحميل التطبيق الكامل وتقديم طلبات HTTP حقيقية عبر `supertest`) تتحقق من أن خط أنابيب الطلب الكامل — التوجيه والحراس والتحقق من الصحة والمعالجات — يعمل معًا بشكل صحيح.

معرفة أدوات الاختبار (`Test.createTestingModule`، تجاوزات موفري النماذج الوهمية)، وكيفية كتابة اختبارات الوحدة واختبارات e2e، واستراتيجية اختبار معقولة (اختبارات وحدة سريعة ومعزولة متعددة، اختبارات e2e كاملة أقل، قاعدة بيانات اختبار) هو سمة من سمات تطوير NestJS الاحترافي.

ويعكس ممارسة الهندسة الناضجة ويستفيد تمامًا مما يجعل معمارية NestJS المنظمة والقائمة على DI قيمة، مما يجعله موضوعًا مهمًا على مستوى مستشار.