NestJS アプリケーションはどのようにテストしますか？

Question

Accepted Answer

NestJS は Jest と統合された組み込みの**テストユーティリティ（`@nestjs/testing`）**を提供しており、その **dependency-injection アーキテクチャによってテストが特にクリーンになります**。テスト用のモジュールを作成し、依存関係に対してモックを注入します。テストは（独立した）ユニットテストと（アプリ全体の）e2e テストに分けられます。

## サービスのユニットテスト（依存関係をモック化）

```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 によって、テストモジュールの providers を通じて**実際の依存関係をモックに差し替えられる**ことです。これにより、実際のデータベースや外部サービスなしに、サービスを単独でテストできます。

## 依存関係を簡単にモック化する

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

クラスが自身の依存関係を生成しない（DI が行う）ため、モックの差し替えは簡単であり、これがクリーンなユニットテストの基盤となります。

## エンドツーエンド（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 テスト**はアプリケーション全体を起動し、（`supertest` を介して）実際の HTTP リクエストを行い、リクエスト全体のフロー（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 のアーキテクチャはそれを際立ってクリーンにします。テストの仕方を理解することは、コード品質のためにも、またこのフレームワークがテスト容易性を*念頭に*設計されているという理由からも重要です。

中心的な洞察は、**dependency injection がモック化を簡単にする**ということです。クラスが依存関係を宣言し DI がそれを供給するため、`@nestjs/testing` モジュールを使えば、任意の依存関係（データベースのリポジトリ、外部サービス、設定）をトークンによってモックに差し替えられます。これにより、実際のインフラなしに、サービス・guard・pipe の高速で独立した**ユニットテスト**が可能になります。

このテスト容易性こそが、NestJS のような DI ベースのフレームワークが高く評価される大きな理由です。

ユニットテストを補完するものとして、**e2e テスト**（アプリ全体を起動し、`supertest` を介して実際の HTTP リクエストを行う）は、routing・guards・validation・handlers といったリクエストパイプライン全体が正しく連携することを検証します。

テストユーティリティ（`Test.createTestingModule`、モック化のための provider のオーバーライド）、ユニットテストと e2e テストの両方の書き方、そして妥当なテスト戦略（多数の高速で独立したユニットテスト、少数の完全な e2e テスト、テスト用データベース）を知っていることは、プロフェッショナルな NestJS 開発の証です。

それは成熟したエンジニアリングの実践を反映し、NestJS の構造化された DI 主導の設計を価値あるものにしている要素そのものを活かすものであり、重要なシニアレベルのトピックとなっています。