🧱 Jest 개념 정리 - 기본 Matcher

공식 문서 참고: https://jestjs.io/docs/using-matchers

---

📘 1️⃣ toBe — 원시값 일치 (===)

💡 개념

toBe는 엄격한 일치(===) 비교를 수행한다.
즉, 값뿐 아니라 타입까지 동일해야 테스트가 통과한다.

💻 예시

test('toBe는 === 비교를 사용한다', () => {
  expect(2 + 2).toBe(4);          // ✅ 4 === 4
  expect('hello').toBe('hello');  // ✅ 문자열 동일
  expect(true).not.toBe(false);   // ✅ 반대값이므로 통과
});

⚠️ 주의

• 객체나 배열은 참조(reference)가 다르면 실패한다.

expect({ a: 1 }).toBe({ a: 1 }); // ❌ 다른 객체

이럴 땐 toEqual을 사용해야 한다.

---

📘 2️⃣ toEqual — 구조적 일치 (deep equality)

💡 개념

toEqual은 객체나 배열 내부의 값까지 비교한다.
즉, 참조가 다르더라도 구조와 값이 같으면 통과한다.

💻 예시

test('toEqual은 객체/배열 내부 값 비교', () => {
  expect({ a: 1, b: 2 }).toEqual({ a: 1, b: 2 });
  expect([1, 2, 3]).toEqual([1, 2, 3]);
});

⚙️ 참고

• toStrictEqual은 toEqual보다 더 엄격하게
  (예: undefined 프로퍼티, 프로토타입 차이까지 검사)

---

📘 3️⃣ toBeTruthy / toBeFalsy — Truthiness 판별

💡 개념

JS에서 true로 평가되는 값 / false로 평가되는 값을 검증할 때 사용한다.
(Truthy / Falsy 개념 기반)

💻 예시

test('Truthy / Falsy 값 판별', () => {
  expect('hello').toBeTruthy(); // ✅ 문자열은 Truthy
  expect(1).toBeTruthy();
  expect(0).toBeFalsy();        // ✅ 0은 Falsy
  expect(null).toBeFalsy();
});

⚠️ 주의

• toBeTruthy()는 value == true가 아님
• 단지 JS에서 "if(value)" 조건문으로 true로 평가되는가를 의미한다.

---

📘 4️⃣ toBeNull / toBeUndefined — 명확한 상태 구분

💡 개념

값이 정확히 null 또는 undefined인지 구분하고 싶을 때 사용한다.

💻 예시

test('null / undefined 명확히 구분', () => {
  const data = { name: null };

  expect(data.name).toBeNull();        // ✅ 정확히 null
  expect(data.age).toBeUndefined();    // ✅ 존재하지 않음
  expect(data.name).not.toBeUndefined();
});

⚙️ 참고

• toBeNull()은 value === null
• toBeUndefined()는 value === undefined

---

📘 5️⃣ toContain — 배열 또는 문자열 포함 여부

💡 개념

배열, 문자열, Set 등 iterable 객체에 특정 요소가 포함되어 있는지 검사한다.

💻 예시

test('배열 또는 문자열 포함 여부', () => {
  const shoppingList = ['milk', 'bread', 'butter'];

  expect(shoppingList).toContain('bread');       // ✅ 포함
  expect('Hello Jest').toContain('Jest');        // ✅ 문자열 포함
  expect(['a', 'b', 'c']).not.toContain('d');    // ✅ 없음
});

⚙️ 참고

• 객체 배열의 일부를 비교하려면 toContainEqual을 사용한다.

expect([{ id: 1 }]).toContainEqual({ id: 1 });

---

📘 6️⃣ toThrow — 예외 발생 검증

💡 개념

함수가 실행될 때 에러가 발생하는지 테스트한다.
메시지나 에러 타입까지 검증 가능하다.

💻 예시

✅ 인자가 없는 함수

function compileCode() {
  throw new Error('syntax error: missing ;');
}

test('compileCode는 에러를 던져야 한다', () => {
  expect(compileCode).toThrow();                      // ✅ 어떤 에러든 발생하면 통과
  expect(compileCode).toThrow('syntax');              // ✅ 메시지 부분 일치
  expect(compileCode).toThrow(/missing ;/);           // ✅ 정규식 일치
  expect(compileCode).toThrow(Error);                 // ✅ Error 타입
  expect(compileCode).toThrow(new Error('syntax error: missing ;')); // ✅ 완전 일치
});

✅ 인자가 필요한 함수

function checkPermission(role) {
  if (role !== 'admin') throw new TypeError('Access denied');
}

test('checkPermission 함수 테스트', () => {
  expect(() => checkPermission('user')).toThrow('Access denied'); // ✅ 문자열 포함
  expect(() => checkPermission('user')).toThrow(/Access denied/); // ✅ 정규식
  expect(() => checkPermission('user')).toThrow(TypeError);       // ✅ 타입 검사
  expect(() => checkPermission('user')).toThrow(new TypeError('Access denied')); // ✅ 타입+메시지 일치
  expect(() => checkPermission('admin')).not.toThrow();           // ✅ 에러 발생하지 않아야 함
});

⚙️ 주의

• expect()에는 함수를 직접 호출하지 말고,
  “함수 자체 또는 래핑 함수”를 전달해야 한다.
  • 인자 없는 함수 → expect(fn)
  • 인자 필요한 함수 → expect(() => fn(args))

---

✅ 마무리 요약

매처	설명	예시
toBe	원시값 일치 (===)	expect(2+2).toBe(4)
toEqual	구조적 일치	expect({a:1}).toEqual({a:1})
toBeTruthy / toBeFalsy	Truthiness 판별	expect(value).toBeFalsy()
toBeNull / toBeUndefined	명확한 null/undefined	expect(null).toBeNull()
toContain	배열/문자열 포함	expect(arr).toContain(3)
toThrow	예외 발생 검사	expect(fn).toThrow()

---