NestJS uygulamalarını nasıl test edersiniz?

Question

Accepted Answer

NestJS, Jest ile entegre edilmiş yerleşik bir **test yardımcısı (`@nestjs/testing`)** sağlar ve **bağımlılık enjeksiyonu mimarisi testi özellikle temiz yapar** — bir test modülü oluşturur ve bağımlılıklar için mock'ları enjekte edersiniz. Testler birim testler (izole) ve e2e testler (tam uygulama) olarak ayrılır.

## Birim testi bir servisi test etmek (mock'lanmış bağımlılıklarla)

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

Ana avantaj: NestJS'nin DI mimarisi, test modülünün providers'ı aracılığıyla **gerçek bağımlılıkları mock'larla değiştirmenize** olanak tanır — böylece servisi izole olarak, gerçek bir veritabanı veya harici servisler olmadan test edersiniz.

## Bağımlılıkları kolayca mock'lamak

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

Sınıflar kendi bağımlılıklarını inşa etmedikleri için (DI bunu yapar), mock'ları ikame etmek önemsizdir — temiz birim testlerin temeli budur.

## Uçtan uca (e2e) test — HTTP üzerinden tam uygulama

```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 testler** tam uygulamayı önyükler ve gerçek HTTP istekleri yapar (`supertest` aracılığıyla), tüm akışın (routing → guards → pipes → handler → response) birlikte çalıştığını doğrular.

## Test stratejisi

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

## Neden önemli

Test, güvenilir uygulamalar için gereklidir ve NestJS'nin mimarisi bunu belirgin şekilde temiz hale getirir — nasıl test edileceğini anlamak hem kod kalitesi hem de çerçeve *test edilebilirlik için tasarlanmış* olduğu için önemlidir.

Merkezî fikir, **bağımlılık enjeksiyonunun mock'lamayı önemsiz hale getirir**: sınıflar bağımlılıklarını bildirir ve DI onları sağladığından, `@nestjs/testing` modülü herhangi bir bağımlılığı (veritabanı repository'leri, harici servisler, yapılandırma) token'ı ile bir mock'la değiştirmenize olanak tanır, gerçek altyapı olmadan hızlı, izole **birim testler** yapmanız mümkün kılar.

Bu test edilebilirlik, NestJS gibi DI tabanlı çerçevelerin değerli olmasının ana nedenlerinden biridir.

Birim testleri tamamlamak için, **e2e testler** (tam uygulamayı önyüklemek ve `supertest` aracılığıyla gerçek HTTP istekleri yapmak) tüm istek hattının — routing, guards, doğrulama, handler'lar — birlikte doğru şekilde çalıştığını doğrular.

Test araçlarını (Test.createTestingModule`, provider override'ları mock'lamak için), hem birim hem de e2e testleri nasıl yazacağınızı ve makul bir test stratejisini (birçok hızlı izole birim test, daha az tam e2e test, bir test veritabanı) bilmek, profesyonel NestJS geliştirmesinin bir göstergesidir.

Bu, olgun mühendislik uygulamasını yansıtır ve tam olarak NestJS'nin yapılandırılmış, DI odaklı tasarımını değerli kılan şeyi kullanır, bu da onu önemli bir üst seviye konu haline getirir.