Jest에 들어가기 전에.. Jest가 대체 뭐지..?

Jest 테스트 문법 소개

Jest는 JavaScript 테스트 프레임워크로, 테스트 코드를 작성할 때 사용하는 주요 문법과 기능들을 설명드리겠습니다. Jest는 describe, it/test, expect, beforeEach/afterEach 등 다양한 기본적인 함수들을 제공합니다.

---

1. describe : 테스트 그룹화

describe는 여러 테스트를 그룹으로 묶을 때 사용합니다. 예를 들어, 동일한 컴포넌트나 함수에 대해 여러 가지 테스트를 실행할 때 describe를 사용해서 관련된 테스트들을 묶을 수 있습니다.

describe('숫자 덧셈 함수 테스트', () => {
  // 여러 개의 테스트 케이스들을 이 안에 넣을 수 있습니다.
});

---

2. it 또는 test : 실제 테스트 케이스

it 또는 test는 각각 하나의 테스트 케이스를 정의할 때 사용합니다. 테스트하고자 하는 내용을 설명하는 문자열과 실제 실행될 코드 블록을 작성합니다.

it('2와 3을 더하면 5가 되어야 한다', () => {
  const result = 2 + 3;
  expect(result).toBe(5);  // 예측하는 값은 5이어야 한다는 의미
});

it과 test는 같은 기능을 하므로 둘 중 하나를 선택해서 사용할 수 있습니다. it은 주로 "It should" 형식의 문장에 어울리고, test는 좀 더 직관적입니다.

---

3. expect : 예상값 비교

expect는 실제 값과 예상값을 비교하는 함수입니다. 예상한 값이 실제로 나오는지 확인하는 데 사용합니다.

expect(2 + 3).toBe(5);  // 5와 일치하는지 비교
expect({name: 'Alice'}).toEqual({name: 'Alice'});  // 객체 내용이 같은지 비교
expect(0).toBeFalsy();        // 0은 falsy이므로 통과

사용 가능한 주요 expect 비교 메서드:

• toBe(expected) : 값이 정확히 expected와 일치하는지 비교
• toEqual(expected) : 값이 객체나 배열인 경우, 내용이 같은지 비교
• toBeTruthy() : 값이 "truthy"인 경우 (예: true, 1, '문자열')
• toBeFalsy() : 값이 "falsy"인 경우 (예: false, null, undefined, 0, NaN)

---

4. beforeEach / afterEach : 테스트 실행 전후에 실행

beforeEach는 각 테스트가 실행되기 전에 실행되는 코드 블록을 정의합니다. afterEach는 각 테스트가 끝난 후에 실행되는 코드입니다.

beforeEach(() => {
  console.log('테스트가 시작되기 전에 실행된다');
});

afterEach(() => {
  console.log('테스트가 끝난 후에 실행된다');
});

---

5. beforeAll / afterAll : 전체 테스트 실행 전후에 실행

beforeAll은 전체 테스트가 실행되기 전에 한 번만 실행되는 코드이고, afterAll은 모든 테스트가 끝난 후 한 번만 실행됩니다. 보통 초기화 작업을 할 때 유용합니다.

beforeAll(() => {
  console.log('전체 테스트가 시작되기 전에 한 번 실행된다');
});

afterAll(() => {
  console.log('전체 테스트가 끝난 후 한 번 실행된다');
});

---

6. toBe 외에 다른 matcher들

expect와 함께 사용할 수 있는 다양한 matcher들입니다:

• toBeNull() : 값이 null인지 확인
• toBeDefined() : 값이 undefined가 아님을 확인
• toBeUndefined() : 값이 undefined인지를 확인
• toBeNaN() : 값이 NaN인지를 확인
• toContain() : 배열이나 문자열에 특정 값이 포함되어 있는지 확인

expect([1, 2, 3]).toContain(2);      // 배열에 2가 있는지 확인
expect('Hello').toContain('ell');   // 문자열에 'ell'이 있는지 

---

7. 실제 예시

그럼 실제로 간단한 함수에 대한 테스트를 작성해 보겠습니다.
예시: sum.js (덧셈 함수)

// sum.js
function sum(a, b) {
  return a + b;
}

module.exports = sum;

예시:sum.test.js(덧셈 함수에 대한 테스트)

// sum.test.js
const sum = require('./sum');

describe('sum 함수 테스트', () => {
  it('2와 3을 더하면 5가 되어야 한다', () => {
    expect(sum(2, 3)).toBe(5);
  });

  it('0과 5를 더하면 5가 되어야 한다', () => {
    expect(sum(0, 5)).toBe(5);
  });

  it('음수와 양수를 더하면 값이 올바르게 계산된다', () => {
    expect(sum(-1, 1)).toBe(0);
  });
});

---

8. 테스트 실행하기

이제 테스트를 실행하려면, Jest 명령어를 사용하여 실행할 수 있습니다. 터미널에서 아래 명령어를 입력하면 됩니다.

npm test  # 혹은 jest

---

9. 테스트 결과 보기

테스트가 성공하면, 아래와 같은 출력이 나타납니다:

PASS  ./sum.test.js
  sum 함수 테스트
    ✓ 2와 3을 더하면 5가 되어야 한다 (5 ms)
    ✓ 0과 5를 더하면 5가 되어야 한다 (1 ms)
    ✓ 음수와 양수를 더하면 값이 올바르게 계산된다 (2 ms)

실패한 경우에는 해당하는 오류 메시지와 함께 실패한 이유를 보여줍니다.

---

이것이 Jest에서 자주 사용하는 기본적인 문법입니다. describe로 테스트 그룹을 만들고, it 또는 test로 각 테스트 케이스를 작성하며, expect로 예상한 값과 실제 값을 비교하는 방식으로 테스트를 작성할 수 있습니다.