Πώς δοκιμάζετε εφαρμογές NestJS;

Question

Accepted Answer

Το NestJS παρέχει ένα ενσωματωμένο **εργαλείο δοκιμής (`@nestjs/testing`)** ολοκληρωμένο με Jest, και η **αρχιτεκτονική έγχυσης εξάρτησης του καθιστά τη δοκιμή ιδιαίτερα καθαρή** — δημιουργείτε ένα δοκιμαστικό module και εγχύετε mocks για τις εξαρτήσεις. Οι δοκιμές χωρίζονται σε unit tests (απομονωμένες) και e2e tests (πλήρης εφαρμογή).

## Unit testing ενός service (με mocked εξαρτήσεις)

```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 σας επιτρέπει να **αντικαταστήσετε τις πραγματικές εξαρτήσεις με mocks** μέσω των providers του δοκιμαστικού module — έτσι δοκιμάζετε το service σε απομόνωση, χωρίς πραγματική βάση δεδομένων ή εξωτερικές υπηρεσίες.

## Mocking εξαρτήσεων εύκολα

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

Επειδή οι κλάσεις δεν κατασκευάζουν τις δικές τους εξαρτήσεις (το DI το κάνει), η αντικατάσταση mocks είναι τετριμμένη — το θεμέλιο καθαρών unit tests.

## End-to-end (e2e) testing — η πλήρης εφαρμογή μέσω 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** εκκινούν την πλήρη εφαρμογή και κάνουν πραγματικά HTTP requests (μέσω `supertest`), επαληθεύοντας ότι ολόκληρη η ροή (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 την καθιστά αξιοσημείωτα καθαρή — η κατανόηση του τρόπου δοκιμής είναι σημαντική τόσο για την ποιότητα του κώδικα όσο και επειδή το framework είναι *σχεδιασμένο* για δοκιμασιμότητα.

Η κεντρική ιδέα είναι ότι η **έγχυση εξάρτησης καθιστά το mocking τετριμμένο**: επειδή οι κλάσεις δηλώνουν τις εξαρτήσεις τους και το DI τις παρέχει, το `@nestjs/testing` module σας επιτρέπει να αντικαταστήσετε οποιαδήποτε εξάρτηση (database repositories, εξωτερικές υπηρεσίες, config) με ένα mock από το token του, ενεργοποιώντας γρήγορα, απομονωμένα **unit tests** των services, guards, και pipes χωρίς πραγματική υποδομή.

Αυτή η δοκιμασιμότητα είναι ένας κύριος λόγος για τον οποίο τα frameworks βασισμένα σε DI όπως το NestJS είναι πολύτιμα.

Συμπληρώνοντας τα unit tests, τα **e2e tests** (εκκίνηση της πλήρης εφαρμογής και κάνοντας πραγματικά HTTP requests μέσω `supertest`) επαληθεύουν ότι ολόκληρη η ροή request — routing, guards, validation, handlers — λειτουργεί μαζί σωστά.

Η γνώση των εργαλείων δοκιμής (`Test.createTestingModule`, provider overrides για mocking), του τρόπου γραφής τόσο unit όσο και e2e tests, και μια λογική στρατηγική δοκιμής (πολλά γρήγορα απομονωμένα unit tests, λιγότερα πλήρη e2e tests, μια δοκιμαστική βάση δεδομένων) είναι χαρακτηριστικό της επαγγελματικής ανάπτυξης NestJS.

Αντανακλά την ώριμη πρακτική μηχανικής και αξιοποιεί ακριβώς αυτό που κάνει το σχεδιασμένο, DI-driven design του NestJS πολύτιμο, καθιστώντας το ένα σημαντικό θέμα ανώτερου επιπέδου.