آپ NestJS ایپلیکیشنز کو کیسے ٹیسٹ کرتے ہیں؟

Question

Accepted Answer

NestJS ایک تعمیر شدہ **ٹیسٹنگ یوٹیلٹی (`@nestjs/testing`)** فراہم کرتا ہے جو Jest کے ساتھ مربوط ہے، اور اس کا **dependency-injection architecture ٹیسٹنگ کو خاص طور پر صاف بناتا ہے** — آپ ایک ٹیسٹنگ ماڈیول بناتے ہیں اور dependencies کے لیے mocks inject کرتے ہیں۔ ٹیسٹز unit tests (الگ تھلگ) اور e2e tests (مکمل ایپ) میں تقسیم ہوتے ہیں۔

## ایک service کو ٹیسٹ کرنا (mocked dependencies کے ساتھ)

```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();
  });
});
```

اہم فائدہ: NestJS کا DI آپ کو **حقیقی dependencies کو mocks سے بدلنے** کی سہولت دیتا ہے ٹیسٹنگ ماڈیول کے providers کے ذریعے — تو آپ service کو الگ تھلگ ٹیسٹ کرتے ہیں، بغیر حقیقی ڈیٹا بیس یا بیرونی سروسز کے۔

## آسانی سے dependencies کو mock کرنا

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

چونکہ classes اپنی dependencies کو تعمیر نہیں کرتیں (DI کرتا ہے)، mocks کو بدلنا معمولی ہے — صاف unit tests کی بنیاد۔

## End-to-end (e2e) ٹیسٹنگ — مکمل ایپ 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 ٹیسٹز** مکمل ایپلیکیشن کو bootstrap کرتے ہیں اور حقیقی HTTP requests بناتے ہیں (`supertest` کے ذریعے)، پورے flow کی تصدیق کرتے ہوئے (routing → guards → pipes → handler → response) مل کر کام کرتے ہیں۔

## ٹیسٹنگ کی حکمت عملی

```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 کی architecture اسے خاص طور پر صاف بناتی ہے — ٹیسٹ کرنے کا طریقہ سمجھنا کوڈ کے معیار اور اس لیے بھی اہم ہے کیونکہ framework *طراح شدہ* ہے testability کے لیے۔

مرکزی نظریہ یہ ہے کہ **dependency injection mocking کو معمولی بناتا ہے**: چونکہ classes اپنی dependencies کا اعلان کرتے ہیں اور DI انہیں فراہم کرتا ہے، `@nestjs/testing` ماڈیول آپ کو کسی بھی dependency (ڈیٹا بیس repositories، بیرونی سروسز، config) کو اس کے token سے mock سے بدلنے دیتا ہے، تیز، الگ تھلگ **unit tests** کو services، guards، اور pipes کے بغیر حقیقی infrastructure کے۔

یہ testability ایک بڑی وجہ ہے کہ DI-based frameworks جیسے NestJS کی قدر کی جاتی ہے۔

Unit tests کو مکمل کرتے ہوئے، **e2e ٹیسٹز** (مکمل ایپ کو bootstrap کرنا اور `supertest` کے ذریعے حقیقی HTTP requests بنانا) یہ تصدیق کرتے ہیں کہ پورا request pipeline — routing، guards، validation، handlers — صحیح طریقے سے مل کر کام کرتے ہیں۔

ٹیسٹنگ utilities کو جاننا (`Test.createTestingModule`, provider overrides mocking کے لیے)، unit اور e2e دونوں ٹیسٹز لکھنا، اور سمجھدارانہ ٹیسٹنگ strategy (بہت سے تیز الگ تھلگ unit tests، کم مکمل e2e ٹیسٹز، ایک ٹیسٹ ڈیٹا بیس) پروفیشنل NestJS development کی نشانی ہے۔

یہ بالغ انجینئرنگ practice کو ظاہر کرتا ہے اور بالکل اس چیز کو استعمال کرتا ہے جو NestJS کی منظم، DI-driven design کو قیمتی بناتی ہے، اسے ایک اہم senior-level موضوع بناتا ہے۔