🧪 NestJS Testing – 유닛 테스트부터 통합 테스트까지 완전 정복

🧪 NestJS Testing – 유닛 테스트부터 통합 테스트까지 완전 정복

---

NestJS는 테스트를 프레임워크 수준에서 강력하게 지원하는 구조를 갖고 있습니다.
이번 글은 NestJS 공식 문서 Testing을 바탕으로,
유닛 테스트(Unit Test), 통합 테스트(Integration Test), 그리고 E2E 테스트를 실무 중심으로 구성했습니다.

💡 “테스트는 선택이 아닌 필수입니다. NestJS는 DI와 모듈 시스템 덕분에 테스트 작성이 매우 쉽습니다.”

---

✅ 테스트 환경 준비

NestJS는 기본적으로 Jest를 테스트 러너로 사용합니다.

✅ 설정 파일

NestJS 프로젝트 생성 시 자동 포함:

- jest.config.ts
- test/jest-e2e.json

✅ 설치 확인

npm run test           # 단위 테스트 실행
npm run test:watch     # 변경 감지 모드
npm run test:cov       # 커버리지 포함 실행
npm run test:e2e       # E2E 테스트 실행

---

1️⃣ 유닛 테스트 (Unit Test)

✅ 서비스 단위 테스트 예시

// cats.service.ts
@Injectable()
export class CatsService {
  getCats() {
    return ['고양이1', '고양이2'];
  }
}

// cats.service.spec.ts
describe('CatsService', () => {
  let service: CatsService;

  beforeEach(() => {
    service = new CatsService();
  });

  it('should return an array of cats', () => {
    expect(service.getCats()).toEqual(['고양이1', '고양이2']);
  });
});

🧪 의존성이 없는 서비스는 new 연산자로 바로 생성하여 테스트 가능

---

📺 광고

이 구간은 테스트 코드가 실제 실행되는 예제가 등장하는 구간으로
애드센스 광고 삽입에 적합한 고주목 영역입니다.

<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-XXXXXX"
     data-ad-slot="YYYYYY"
     data-ad-format="auto"
     data-full-width-responsive="true"></ins>

---

2️⃣ 의존성 주입이 있는 유닛 테스트

반응형

✅ DI가 필요한 경우 TestingModule 사용

// cats.service.ts
@Injectable()
export class CatsService {
  constructor(private readonly httpService: HttpService) {}

  async fetchCats(): Promise<string[]> {
    const res = await this.httpService.get('https://api.example.com/cats').toPromise();
    return res.data;
  }
}
</string[]>

✅ 테스트 설정

describe('CatsService (with DI)', () => {
  let service: CatsService;

  beforeEach(async () => {
    const module: TestingModule = await Test.createTestingModule({
      providers: [
        CatsService,
        {
          provide: HttpService,
          useValue: {
            get: jest.fn().mockReturnValue({
              toPromise: () => Promise.resolve({ data: ['cat1', 'cat2'] }),
            }),
          },
        },
      ],
    }).compile();

    service = module.get<CatsService>(CatsService);
  });

  it('should fetch cats', async () => {
    expect(await service.fetchCats()).toEqual(['cat1', 'cat2']);
  });
});

✅ Test.createTestingModule()을 사용하면 NestJS의 DI 시스템을 테스트에서 그대로 사용할 수 있습니다.

---

3️⃣ 컨트롤러 + 서비스 통합 테스트

// cats.controller.ts
@Controller('cats')
export class CatsController {
  constructor(private readonly catsService: CatsService) {}

  @Get()
  getCats() {
    return this.catsService.getCats();
  }
}

✅ 테스트 설정

describe('CatsController', () => {
  let controller: CatsController;

  beforeEach(async () => {
    const module = await Test.createTestingModule({
      controllers: [CatsController],
      providers: [
        {
          provide: CatsService,
          useValue: {
            getCats: jest.fn().mockReturnValue(['테스트 고양이']),
          },
        },
      ],
    }).compile();

    controller = module.get<CatsController>(CatsController);
  });

  it('should return cats', () => {
    expect(controller.getCats()).toEqual(['테스트 고양이']);
  });
});

---

4️⃣ E2E 테스트 (End-to-End)

NestJS는 E2E 테스트를 supertest와 함께 기본 제공하며 test/app.e2e-spec.ts에 기본 템플릿이 포함됩니다.

✅ 예시

import * as request from 'supertest';
import { Test } from '@nestjs/testing';
import { INestApplication } from '@nestjs/common';
import { AppModule } from '../src/app.module';

describe('AppController (e2e)', () => {
  let app: INestApplication;

  beforeAll(async () => {
    const moduleFixture = await Test.createTestingModule({
      imports: [AppModule],
    }).compile();

    app = moduleFixture.createNestApplication();
    await app.init();
  });

  it('/cats (GET)', () => {
    return request(app.getHttpServer())
      .get('/cats')
      .expect(200)
      .expect(['고양이1', '고양이2']);
  });
});

---

🧠 실무 전략

테스트 유형 목적 도구

Unit Test	단일 함수, 서비스 로직 검증	Jest
Integration	여러 모듈, DI 포함 서비스 테스트	Jest + Test.createTestingModule()
E2E Test	실제 HTTP 요청 기반 전체 흐름 테스트	Jest + Supertest

---

🔧 테스트 실행 명령 요약

명령어 설명

npm run test	유닛 테스트 수행
npm run test:cov	커버리지 리포트 포함 테스트 실행
npm run test:e2e	E2E 테스트 수행
npm run test:watch	파일 변경 시 자동 테스트

---

✅ 마무리 요약

개념 설명

Test.createTestingModule()	DI 환경을 테스트에서 구성하는 핵심 도구
Mock Provider	서비스 테스트에서 의존성 주입 대체
E2E 테스트	실제 요청-응답 흐름을 검증하여 전체 시스템 테스트 수행
커버리지 체크	--coverage 플래그로 커버리지 리포트 생성 가능

---

 

NestJS 테스트,NestJS Unit Test,NestJS Integration Test,NestJS E2E Test,NestJS Jest 설정,NestJS Mocking,NestJS Test.createTestingModule,NestJS 테스트 코드,NestJS 테스트 실무,NestJS Coverage 보고서

---