🧱 Jest 개념 정리 - 비대칭(Asymmetric) 매처

참고: Expect Reference

---

1) 비대칭(Asymmetric) 매처란?

• 일반 매처는 expect(value).toEqual(expected)처럼 왼쪽(actual)을 검사한다.
• 비대칭 매처는 expected 쪽(우항)에 놓여서, “기대값을 ‘조건’으로 표현”한다.
• 즉, 정확한 값 대신 타입/패턴/존재성 같은 조건을 쓴다.

expect(getUser()).toEqual({
  id: expect.any(Number),        // ← 값 대신 조건(타입)
  name: expect.any(String),
  email: expect.stringMatching(/@/), // ← 패턴(정규식)
});

장점: “값이 정확히 X여야 한다” 대신 “이런 조건을 만족하면 OK” 형태로 의도를 드러낼 수 있다.

---

2) 이번 정리에서 다룰 매처

• expect.any(constructor)
• expect.anything()
• expect.stringContaining(substr)
• expect.stringMatching(regexOrString)

---

3) 매처별 개념 & 사용 예시

3-1) expect.any(constructor) — 해당 타입이면 통과

• Number, String, Boolean, Function, Object, Array, Date 등 생성자 가능
• “값은 바뀔 수 있어도 타입은 고정”일 때 유용

test('타입만 보장', () => {
  const user = { id: 42, name: 'Kim', createdAt: new Date() };
  expect(user).toEqual({
    id: expect.any(Number),
    name: expect.any(String),
    createdAt: expect.any(Date),
  });
});

// 배열 내에서도 사용 가능 (부분일치 아님: 전체 구조가 일치해야 함)
expect([123, 'abc']).toEqual([expect.any(Number), expect.any(String)]);

비교 포인트: typeof value === 'number'를 테스트 본문에서 굳이 쓰지 않고, 검증 문장을 데이터 모양 옆에 붙여 가독성을 높인다.

---

3-2) expect.anything() — null/undefined 제외한 임의의 값이면 통과

• “여긴 값이 오긴 와야 하는데, 무엇인지는 중요하지 않아” 상황

test('존재성만 확인', () => {
  const res = { token: 'abc123', payload: { /* ... */ } };
  expect(res).toEqual({
    token: expect.anything(),  // null/undefined만 아니면 OK
    payload: expect.any(Object)
  });
});

팁: 네트워크 응답의 id, token, requestId처럼 있기만 하면 되는 필드에 적합.

---

3-3) expect.stringContaining(substr) — 문자열에 부분 문자열 포함

• 정규식보다 단순한 부분 포함을 빠르게 표현

test('부분 문자열 포함', () => {
  const msg = 'Hello, Jest and Testing Library!';
  expect(msg).toEqual(expect.stringContaining('Jest'));
  expect(msg).not.toEqual(expect.stringContaining('Mocha'));
});

언제 쓰나: 라벨/메시지/로그 라인처럼 “이 단어만 들어가면 충분”한 검증.

---

3-4) expect.stringMatching(regexOrString) — 문자열이 패턴에 매칭

• 정규식 또는 문자열을 받아 패턴 일치 검사
• stringContaining보다 표현력이 더 풍부

test('정규식 패턴 일치', () => {
  const code = 'user-001';
  expect(code).toEqual(expect.stringMatching(/^user-\d+$/));

  const email = 'dev@ex.com';
  expect(email).toEqual(expect.stringMatching(/.+@.+\..+/));
});

언제 쓰나: 아이디 포맷, 버전 문자열, 날짜/시간 포맷 등 형식을 검증할 때.

---

4) 조합 예시 (부분일치 없이도 충분히 강력)

const makeOrder = () => ({
  orderId: 'ORD-2025-0001',
  buyer: { id: 7, name: 'Lee' },
  items: [
    { sku: 'A-01', qty: 2 },
    { sku: 'B-99', qty: 1 },
  ],
  createdAt: new Date().toISOString(),
});

test('주문 객체의 타입/패턴만 보장 (부분일치 미사용)', () => {
  const order = makeOrder();
  expect(order).toEqual({
    orderId: expect.stringMatching(/^ORD-\d{4}-\d{4}$/),
    buyer: {
      id: expect.any(Number),
      name: expect.any(String),
    },
    items: [
      { sku: expect.any(String), qty: expect.any(Number) },
      { sku: expect.any(String), qty: expect.any(Number) },
    ],
    createdAt: expect.any(String), // ISO 문자열이라고 가정 (더 엄격히 하려면 정규식 사용)
  });
});

포인트: 전체 구조는 그대로 두고, 내부 값들만 타입/패턴으로 유연하게 표현.
배열도 정확히 그 길이/순서를 기대한다면 이렇게 쓰면 된다(부분일치 아님).

---

5) 흔한 오해 & 주의

• expect.any(Number)는 타입만 본다. 구간/범위 검사는 toBeGreaterThan/toBeCloseTo 등 숫자 매처를 활용.
• expect.anything()은 null/undefined만 거른다. 빈 문자열 ''이나 0은 허용된다는 점 주의.
• stringContaining/stringMatching은 우항에만 쓴다. 즉, toEqual(여기)의 expected 쪽.

---

6) 미니 치트시트

매처	핵심	예시
expect.any(Ctor)	타입만 보장	{ id: expect.any(Number) }
expect.anything()	존재성만 보장(null/undefined 제외)	{ token: expect.anything() }
expect.stringContaining(substr)	부분 문자열 포함	expect(str).toEqual(expect.stringContaining('Jest'))
expect.stringMatching(re)	정규식/문자열 패턴 일치	expect(code).toEqual(expect.stringMatching(/^ID-\d+$/))

---