Kif tittestja applikazzjonijiet NestJS?

Question

Accepted Answer

NestJS tipprovdi utility ta' test integrat (`@nestjs/testing`) integrat ma' Jest, u l-**arkitettura ta' dependency-injection tagħha tagħmilha espesyalment nadifa** — inti toħloq modulu ta' test u tinjeċta mocks għad-dipendenzji. It-tests jaqgħu f'unit tests (iżolati) u e2e tests (full app).

## Unit testing ta' servizz (b'dipendenzji mockati)

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

L-avvantatġġ ewlieni: NestJS's DI jippermettilek **ibdel dipendenzji reali b'mocks** permezz tal-providers tal-modulu ta' test — hekk inti tittestja s-servizz bħala iżolat, mingħajr database reali jew servizzi esterni.

## Immockjar ta' dipendenzji faċilment

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

Għax il-klassez ma jikkonstruixxux id-dipendenzji tagħhom (DI jagħmel dan), is-sostituzzjoni ta' mocks hija trivjali — il-fondazzjoni ta' unit tests nadifa.

## End-to-end (e2e) testing — il-full app fuq 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 tests** jistartjaw l-applikazzjoni sħiħa u jagħmlu real HTTP requests (permezz ta' `supertest`), jivverifikaw li l-fluss sħiħ (routing → guards → pipes → handler → response) jaħdem flimkien.

## Strateġija ta' test

```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.
```

## Għaliex importanti

It-test huwa essenzjali għal applikazzjonijiet affidabbli, u l-arkitettura ta' NestJS tagħmilha notevolment nadifa — il-fehim kif tittestja huwa importanti kemm għall-kwalità tal-kodiċi u għax il-framework huwa *dizziniat* għat-testability.

L-insight ċentrali huwa li **dependency injection jagħmel il-mocking trivjali**: għax il-klassez jiddikjaraw id-dipendenzji tagħhom u DI jipprovdihom, il-modulu `@nestjs/testing` jippermettilek ibdel kwalunkwe dipendenza (database repositories, servizzi esterni, config) b'mock permezz it-token tiegħu, li jippermettu mabda iżolati u veloċi **unit tests** ta' servizzi, guards, u pipes mingħajr infrastruktura reali.

Di l-testability hija raġuni maġġuri għaliex il-frameworks ibbazati fuq DI bħal NestJS huma valurati.
":