계층구조형 (BDD, Behave Driven Development) 테스트 작성법

개요

Describe, Context, It 패턴은 기본적으로 자바스크립트 테스팅 프레임워크인 mocha 에서 지원하는 BDD (Behave Driven Development) 문법이다.

목적

단순히 테스트를 이용해 신뢰성 있는 앱을 만드는 것만이 목적이 아니다. 다양한 테스트를 만들면서 설계에 대한 문제나 유저의 사용성에 대한 문제들도 생각해보고 고칠 수도 있고, 스스로 문제를 내고 해답을 맞춰가는 쾌감을 통해 개발에서 재미를 느낄 수도 있다.

우리가 지켜야 할 규칙

Describe, Context, It 이라는 세 키워드를 목적에 맞게 잘 사용해야 한다.

• Describe: 설명할 테스트 대상을 명시한다.
• Context: 대상이 놓인 상황을 설명한다.
• It 대상의 행동을 설명한다.

Describe 작성 예제

맥락을 전부 표현하지 말고, 깔끔하게 설명할 테스트 대상이 무엇인지만 명시하자.

클래스의 메서드 명이라면, . 을 붙이는 등의 규칙을 활용해보자.

BAD CASE

describe '사용자에 대한 인증 메서드는' do
describe '만일 사용자가 관리자 권한을 가졌다면' do

GOOD CASE

describe '.authenticate' do
describe '#admin?' do

Context 와 It 작성 예제

테스트를 분명히 하고 잘 정렬되게 만드는 데에 도움을 준다. 잘 작성되어 있다면 테스트가 잘 읽힐 것이다. 주로 'when', 'with', 'without' 과 같은 명세와 함께 쓰인다.

BAD CASE

it 'has 200 status code if logged in' do
  expect(response).to respond_with 200
end

it 'has 401 status code if not logged in' do
  expect(response).to respond_with 401
end

• 적절한 상황을 표현하는 context 가 먼저 왔을 경우에 계층구조상 더욱 명확한 테스트 코드가 되었을 수 있다.

GOOD CASE

context 'when logged in' do
  it { is_expected.to respond_with 200 }
end

context 'when logged out' do
  it { is_expected.to respond_with 401 }
end

• context 로 상황을 먼저 표현해주고 it 으로 행위를 설명하니 더욱 명확하다.

명세는 항상 최대한 짧게 가져가자

BAD CASE

it 'has 422 status code if an unexpected params will be added' do

• 계층형 테스트 코드를 작성하면 이렇게 장황한 문장이 되지 않을 수 있다.

GOOD CASE

context 'when not valid' do
  it { is_expected.to respond_with 422 }
end

• 앞서 배워봤듯, 우리는 context 옆에 상황, it 옆에 행위가 올 것을 미리 알고 있었기에 더 쉽게 읽힌다.

레퍼런스

https://johngrib.github.io/wiki/junit5-nested/
https://mochajs.org/
https://docs.cypress.io/guides/core-concepts/writing-and-organizing-tests#Writing-tests
https://www.betterspecs.org/