🧱 Jest 개념 정리 - Modifier(not, resolves, rejects)

Jest 공식 문서 참고: https://jestjs.io/docs/expect#reference

---

🎯 Modifier란?

Modifier(수정자)는 Jest에서 매처의 동작을 바꾸는 속성이다.
즉, expect()가 반환하는 Expectation 객체에 붙어서
매처의 결과를 반전시키거나 비동기 처리를 기다리도록 만들어준다.

expect(value)
  .not.toBe(...)        // 결과 반전
  .resolves.toEqual(...) // Promise resolve 검증
  .rejects.toThrow(...)  // Promise reject 검증

---

1️⃣ not — 결과 반전

📘 개념

not은 매처의 비교 결과를 반대로 뒤집는다.
즉, “~이 아니다”를 테스트하고 싶을 때 사용한다.

expect(2 + 2).not.toBe(5);
expect(['apple', 'banana']).not.toContain('orange');

이 구문을 읽으면

“2 더하기 2는 5가 아니다.”
“배열에 orange는 포함되어 있지 않다.”

처럼 문장으로 자연스럽게 읽히는 테스트가 된다.

---

2️⃣ resolves — Promise가 성공적으로 이행(resolve)될 것을 기대

📘 개념

비동기 테스트에서, resolves는
Promise가 정상적으로 resolve되어 반환된 값을 검증할 때 사용한다.

즉,

"이 Promise는 성공적으로 끝나야 하며, 결과값은 …이다."

를 표현하는 구문이다.

💻 예시 코드

const fetchData = () => Promise.resolve({ status: 'ok', data: [1, 2, 3] });

test('fetchData가 정상적으로 완료되어 status가 ok여야 한다', async () => {
  await expect(fetchData()).resolves.toEqual(
    expect.objectContaining({ status: 'ok' })
  );
});

위 코드는 내부적으로 아래와 동일한 의미다 👇

const result = await fetchData();
expect(result).toEqual(expect.objectContaining({ status: 'ok' }));

✅ 요약

• await expect(Promise).resolves.매처()
• Promise가 resolve된 값에 대해 매처 검증 수행
• await를 반드시 붙여야 함 (테스트 종료 타이밍 중요)

---

3️⃣ rejects — Promise가 실패(reject)될 것을 기대

📘 개념

비동기 로직이 실패할 것으로 예상될 때,
그 reject된 이유(에러 객체) 를 검증할 수 있다.

즉,

"이 Promise는 실패할 것이며, 에러 메시지는 …일 것이다."

를 표현한다.

💻 예시 코드

const fetchDataWithError = () => Promise.reject(new Error('Unauthorized'));

test('fetchDataWithError가 Unauthorized 에러로 reject되어야 한다', async () => {
  await expect(fetchDataWithError()).rejects.toThrow('Unauthorized');
});

이 구문은 아래와 동일한 로직이다 👇

try {
  await fetchDataWithError();
} catch (error) {
  expect(error).toThrow('Unauthorized');
}

✅ 요약

• await expect(Promise).rejects.매처()
• reject된 Promise의 오류 메시지나 타입을 검증
• 실패가 예상되는 비동기 로직 테스트에 적합

---

⚠️ 주의할 점

1. resolves / rejects는 Promise에만 사용 가능하다.

   • Promise가 아닌 값에 쓰면 Jest가 에러를 던진다.
   • 예: expect(123).resolves.toBe(123) ❌

2. await를 꼭 붙여야 한다.

   • await 없이 작성하면 테스트가 먼저 끝나버릴 수 있다.

3. not은 모든 매처에서 사용 가능하지만,
   resolves / rejects는 비동기 매처 전용 Modifier다.