Jest 정리

설치

npm install --save-dev jest
or
yarn add --dev jest

숫자 두개를 더해서 반환하는 함수를 만들어 본다 (sum.js)

function sum(a, b) {
  return a + b;
}
module.exports = sum;

그 다음 (sum.test.js) 파일을 만든다

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

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

그 후 package.json에

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

을 추가해준 다음 yarn test or npm test를 하면 Jest가 해당 메시지를 출력한다

PASS  ./sum.test.js
✓ adds 1 + 2 to equal 3 (5ms)

Matchers(매처)

Jest는 매처를 사용하여 다양한 방식으로 테스트가 가능하다.

가장 간단한 값이 정확히 일치하는지 확인하는 방법이다

test('two plus two is four', () => {
  expect(2 + 2).toBe(4);
});

이 코드에서 expect(2 + 2)는 기대되는 값을 반환하고
.toBe(4)는 매처이다
즉 정확하게 일치하는지 확인하는데 사용하는 매처이다.

객체의 값을 확인하려면 toEqual 또는 toStrictEqual을 사용한다

test('object assignment', () => {
  const data = {one: 1};
  data['two'] = 2;
  expect(data).toEqual({one: 1, two: 2});
});

toEqual은 객체 또는 배열의 모든 요소를 재귀적으로 검사합니다.

toEqual을 사용하는것보다 toStrictEqual을 사용하는것이 더 좋다
이유는 toEqual은 undefined를 무시하지만 toStrictEqual은 undefined도 고려하기 때문이다.

not을 사용하면 일치하지 않는지 여부도 테스트 가능하다.

test('adding positive numbers is not zero', () => {
  for (let a = 1; a < 10; a++) {
    for (let b = 1; b < 10; b++) {
      expect(a + b).not.toBe(0);
    }
  }
});

True 체크

false 테스트에서 undefined와 null을 구분해야 하는 경우가 있지만 구분하고 싶지 않을때도 있다.
그럴때는 하위 헬퍼 메소드를 쓰면된다.

• toBeNull : null만 일치
• toBeUndefined: undefined만 일치
• toBeDefined: toBeUndefined의 반대 즉 undefined와 일치하지 않는것들과 일치
• toBeTruthy: if문이 true로 취급하는 모든 항목과 일치
• toBeFalsy: if문이 false로 취급하는 모든 항목과 일치

test('null', () => {
  const n = null;
  expect(n).toBeNull();
  expect(n).toBeDefined();
  expect(n).not.toBeUndefined();
  expect(n).not.toBeTruthy();
  expect(n).toBeFalsy();
});

test('zero', () => {
  const z = 0;
  expect(z).not.toBeNull();
  expect(z).toBeDefined();
  expect(z).not.toBeUndefined();
  expect(z).not.toBeTruthy();
  expect(z).toBeFalsy();
});

Number(숫자)

test('two plus two', () => {
  const value = 2 + 2;
  expect(value).toBeGreaterThan(3);
  expect(value).toBeGreaterThanOrEqual(3.5);
  expect(value).toBeLessThan(5);
  expect(value).toBeLessThanOrEqual(4.5);

  // toBe and toEqual are equivalent for numbers
  expect(value).toBe(4);
  expect(value).toEqual(4);
});

부동 소수점의 동등성을 위해 toEqual 대신 toBeCloseTo을 사용하자

test('adding floating point numbers', () => {
  const value = 0.1 + 0.2;
  //expect(value).toBe(0.3);           This won't work because of rounding error
  expect(value).toBeCloseTo(0.3); // This works.
});

String(문자열)

toMatch를 사용하여 정규식에 대해 일치여부 확인이 가능하다

test('there is no I in team', () => {
  expect('team').not.toMatch(/I/);
});

test('but there is a "stop" in Christoph', () => {
  expect('Christoph').toMatch(/stop/);
});

Arrays and iterables (배열과 이터러블)

toContain를 사용하면 배열이나 이터러블에 특정 항목 포함 여부를 확인할 수 있다.

const shoppingList = [
  'diapers',
  'kleenex',
  'trash bags',
  'paper towels',
  'milk',
];

test('the shopping list has milk on it', () => {
  expect(shoppingList).toContain('milk');
  expect(new Set(shoppingList)).toContain('milk');
});

Exceptions (예외)

특정 함수가 호출될 때 오류가 발생하는지 여부를 테스트하려면 toThrow를 사용한다.

function compileAndroidCode() {
  throw new Error('you are using the wrong JDK!');
}

test('compiling android goes as expected', () => {
  expect(() => compileAndroidCode()).toThrow();
  expect(() => compileAndroidCode()).toThrow(Error);

  // You can also use a string that must be contained in the error message or a regexp
  expect(() => compileAndroidCode()).toThrow('you are using the wrong JDK');
  expect(() => compileAndroidCode()).toThrow(/JDK/);

  // Or you can match an exact error mesage using a regexp like below
  expect(() => compileAndroidCode()).toThrow(/^you are using the wrong JDK$/); // Test fails
  expect(() => compileAndroidCode()).toThrow(/^you are using the wrong JDK!$/); // Test pass
});

예외를 발생시키는 함수는 래핑 함수 내에서 호출되어야 합니다. 그렇지 않으면 toThrow가 실패합니다.