1. Right-BICEP 원칙이란 ?

"Right-BICEP"은 효과적인 단위 테스트를 위한 기본 원칙들을 나타내는 약어이며, 테스트가 중점을 두어야 하는 핵심 영역들을 강조한다.

1) R - Right (정확함)

---

💬  상황

테스트가 실제로 중요한 사항을 검증하고 있는지 확인해야 한다. 예를 들어, 사용자의 이메일 주소 형식이 올바른지 검증하는 테스트의 경우, 다양한 형식의 이메일 주소에 대한 테스트를 진행하여, 실제로 유효한 형식의 이메일 주소만을 허용하도록 해야 한다.

💻  예시 코드

const { validateEmail } = require('./validation');

describe('Email Validation Tests', () => {
  test('should validate email address correctly', () => {
    expect(validateEmail('test@example.com')).toBeTruthy();
    expect(validateEmail('invalid-email')).toBeFalsy();
  });
});

// validation.js
function validateEmail(email) {
  const re = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
  return re.test(email);
}

module.exports = { validateEmail };

• 이 코드는 이메일 주소가 올바른 형식인지 검증하는 validateEmail 함수에 대한 테스트를 보여준다. 유효한 이메일 형식 ('test@example.com')과 유효하지 않은 이메일 형식 ('invalid-email')에 대한 검증을 수행함으로써, 이메일 주소의 정확한 형식을 올바르게 검증하는지 확인한다. 이처럼 중요한 사항을 정확히 검증하는 테스트는 소프트웨어의 신뢰성을 높이는 데 기여한다.

2) B - Boundary Conditions (경계 조건)

---

💬  상황

경계 조건 테스트는 배열, 리스트, 문자열 등의 경계에서 발생할 수 있는 특별한 상황들을 다룬다. 예를 들어, 배열의 첫 번째나 마지막 요소를 처리하는 로직, 빈 배열이나 문자열을 다루는 로직 등이 이에 해당한다. 이러한 경계 조건에서도 코드가 올바르게 작동하는지 확인하는 것이 중요하다.

💻  예시 코드

const { getLastItem } = require('./arrayUtil');

describe('Array Boundary Conditions Tests', () => {
  test('should handle empty array', () => {
    expect(getLastItem([])).toBeNull();
  });

  test('should return last item for non-empty array', () => {
    expect(getLastItem([1, 2, 3])).toBe(3);
  });
});

// arrayUtil.js
function getLastItem(array) {
  if (array.length === 0) return null;
  return array[array.length - 1];
}

module.exports = { getLastItem };

• 이 코드는 배열의 경계 조건을 테스트한다. getLastItem 함수는 주어진 배열의 마지막 요소를 반환하는데, 빈 배열일 경우 null을 반환해야 한다. Jest를 사용하여 빈 배열과 비어 있지 않은 배열 모두를 테스트함으로써, 이 함수가 배열의 경계 조건에서도 올바르게 작동하는지 검증한다. 경계 조건을 테스트함으로써 소프트웨어의 견고함을 높일 수 있다.

3) I - Inverse Relationship (역 관계)

---

💬  상황

역 관계 테스트는 소프트웨어의 다른 부분이 반대 또는 상호 보완적인 기능을 수행하는지 확인한다. 예를 들어, 추가(Add) 기능을 테스트한 후, 제거(Remove) 기능을 테스트하여 두 기능이 서로 올바르게 동작하는지 확인하는 경우가 이에 해당한다.

💻  예시 코드

const { addItem, removeItem, getItems } = require('./listManager');

describe('List Inverse Relationship Tests', () => {
  test('adding and then removing an item should result in an empty list', () => {
    addItem('apple');
    removeItem('apple');
    expect(getItems()).toEqual([]);
  });
});

// listManager.js
let items = [];

function addItem(item) {
  items.push(item);
}

function removeItem(item) {
  const index = items.indexOf(item);
  if (index > -1) {
    items.splice(index, 1);
  }
}

function getItems() {
  return items;
}

module.exports = { addItem, removeItem, getItems };

• 이 코드에서는 addItem으로 항목을 추가하고, removeItem으로 같은 항목을 제거한 후, getItems를 사용하여 최종 목록이 비어 있는지 검증한다. 이런 역 관계 테스트는 소프트웨어의 서로 다른 기능들이 상호 보완적으로 올바르게 작동하는지 확인하는 데 유용하다.

4) C - Cross-check (교차 검증)

---

💬  상황

교차 검증은 서로 다른 방식으로 계산하거나 확인하는 것을 의미한다. 예를 들어, 두 가지 다른 알고리즘으로 동일한 결과를 계산하여 두 결과를 비교하는 것이다. 이 방식으로, 알고리즘의 정확성을 보다 확실하게 검증할 수 있다.

💻  예시 코드

const { sumDirect, sumIterative } = require('./sumCalculators');

describe('Sum Calculation Cross-Check Tests', () => {
  test('both sum calculation methods should return the same result', () => {
    const numbers = [1, 2, 3, 4, 5];
    expect(sumDirect(numbers)).toEqual(sumIterative(numbers));
  });
});

// sumCalculators.js
function sumDirect(numbers) {
  return numbers.reduce((a, b) => a + b, 0);
}

function sumIterative(numbers) {
  let sum = 0;
  for (let num of numbers) {
    sum += num;
  }
  return sum;
}

module.exports = { sumDirect, sumIterative };

• 이 코드에서는 sumDirect 메서드가 reduce 함수를 사용하여 배열의 합을 계산하고, sumIterative 메서드는 반복문을 사용하여 동일한 작업을 수행한다. 두 메서드가 동일한 입력에 대해 동일한 결과를 반환하는지 Jest로 테스트하여 교차 검증한다.

5) E - Error conditions (오류 조건)

---

💬  상황

오류 조건 테스트는 소프트웨어가 예상 및 예상치 못한 오류 상황에서 올바르게 동작하는지 확인한다. 예를 들어, 잘못된 입력값, 시스템 리소스 부족, 의존 서비스의 실패 등 다양한 오류 상황을 시뮬레이션하고 적절한 오류 처리가 이루어지는지 검사한다.

💻  예시 코드

const { processData } = require('./dataProcessor');

describe('Error Conditions Test', () => {
  test('should handle invalid input gracefully', () => {
    expect(() => processData(null)).toThrow('Invalid input');
    expect(() => processData({})).toThrow('Invalid data structure');
  });

  test('should handle external service failure', async () => {
    // 여기서는 외부 서비스 실패를 시뮬레이션하는 방법이 포함될 수 있습니다.
    // 예를 들어, Mock이나 Spy를 사용하여 네트워크 오류를 시뮬레이션 할 수 있다.
    // 해당 부분은 프로젝트와 테스트 환경에 따라 다르게 구현될 수 있다.
  });
});

// dataProcessor.js
function processData(data) {
  if (!data) {
    throw new Error('Invalid input');
  }
  // ... 데이터 처리 로직 ...
}

module.exports = { processData };

• 이 코드는 processData 함수가 유효하지 않거나 예상치 못한 입력값을 받았을 때 적절한 오류 메시지를 발생시키는지 테스트한다. 이러한 종류의 테스트는 예외 상황에서도 시스템이 견고하게 동작하는지 확인하는 데 중요하다.

6) P - Performance characteristics (성능 특성)

---

💬  상황

성능 특성 테스트는 소프트웨어의 처리 속도, 메모리 사용량, 디스크 공간 사용 등의 성능 지표를 평가한다. 예를 들어, 웹 애플리케이션의 API 응답 시간을 측정하거나, 대용량 데이터 처리 시 메모리 사용량을 분석할 수 있다.

💻  예시 코드

const { largeDataProcessor } = require('./processor');

describe('Performance Test', () => {
  test('should process data within acceptable time', () => {
    const largeData = generateLargeData(); // 대용량 데이터 생성 함수
    const startTime = performance.now();

    largeDataProcessor(largeData);

    const endTime = performance.now();
    const processingTime = endTime - startTime;

    expect(processingTime).toBeLessThan(1000); // 1000ms 이내 완료되어야 함
  });

  test('should not exceed memory limit', () => {
    const largeData = generateLargeData();

    const initialMemoryUsage = process.memoryUsage().heapUsed;
    largeDataProcessor(largeData);
    const finalMemoryUsage = process.memoryUsage().heapUsed;

    expect(finalMemoryUsage - initialMemoryUsage).toBeLessThan(100000000); // 100MB 이내로 제한
  });
});

// processor.js
function largeDataProcessor(data) {
  // ... 대용량 데이터 처리 로직 ...
}

module.exports = { largeDataProcessor };

• 이 코드는 대용량 데이터 처리 함수 largeDataProcessor가 정해진 시간 내에 데이터를 처리할 수 있으며, 메모리 사용량이 특정 한계를 넘지 않는지 확인한다. 이러한 성능 테스트는 시스템의 효율성과 확장성을 검증하는 데 중요하다.