타입스크립트로 단위 테스트를 작성하는 것은 소프트웨어 개발에서 매우 중요한 부분입니다. 이를 효율적으로 수행하기 위해서는 테스트 러너를 설정하여야 합니다. 본 문서에서는 타입스크립트 프로젝트에서 단위 테스트를 작성하고, 이를 실행하기 위한 테스트 러너 설정 방법을 안내하겠습니다.

단위 테스트 작성

우선, 타입스크립트로 작성된 소스코드에 대한 단위 테스트를 작성하는 방법을 알아보겠습니다. Jest를 사용하여 간단한 예제 테스트를 작성해보겠습니다.

// mathFunctions.ts
export function add(a: number, b: number): number {
  return a + b;
}

export function subtract(a: number, b: number): number {
  return a - b;
}

// mathFunctions.test.ts
import { add, subtract } from "./mathFunctions";

test("adds 1 + 2 to equal 3", () => {
  expect(add(1, 2)).toBe(3);
});

test("subtracts 2 from 5 to equal 3", () => {
  expect(subtract(5, 2)).toBe(3);
});

위의 코드에서는 mathFunctions.ts에 있는 간단한 두 개의 함수에 대한 테스트 케이스를 mathFunctions.test.ts에 작성하였습니다.

테스트 러너 설정

Jest를 사용하여 타입스크립트 단위 테스트를 실행하기 위해서는 몇 가지 설정이 필요합니다.

1. Jest 및 관련 패키지 설치
   먼저 프로젝트 디렉토리에서 다음 명령을 사용하여 필요한 패키지를 설치합니다.

   npm install --save-dev jest @types/jest ts-jest typescript
   

2. Jest 설정 파일 생성
   프로젝트 루트 디렉토리에 jest.config.js 파일을 생성하고 다음과 같이 내용을 작성합니다.

   module.exports = {
     preset: 'ts-jest',
     testEnvironment: 'node',
   };
   

3. npm 스크립트 추가
   package.json 파일에 다음과 같이 테스트 실행을 위한 npm 스크립트를 추가합니다.

   "scripts": {
     "test": "jest"
   }
   

위의 설정을 완료하면, 타입스크립트로 작성된 단위 테스트를 실행하기 위해 npm test 명령을 사용할 수 있습니다.

이제 타입스크립트로 단위 테스트를 작성하고, Jest를 사용하여 테스트 러너를 설정하는 방법에 대해 알아보았습니다. 이를 통해 코드 변경 시 안정성을 검증하고, 코드 품질을 향상시킬 수 있습니다.

더 자세한 내용은 Jest 공식 문서를 참조하시기 바랍니다.