E2E 테스트 시나리오 선정 기준

"뭘 테스트해야 하지?"

Playwright를 설치하고, 설정 파일을 작성하고, 첫 번째 예제 테스트를 실행하는 것까지는 어렵지 않다. 진짜 어려운 건 그 다음이다.

"어떤 시나리오를 E2E로 테스트해야 하지?"

이 질문에 답하지 못하면 두 가지 극단에 빠지게 된다:

• 모든 것을 E2E로 테스트하려다가 느리고 불안정한 테스트 스위트를 얻거나
• 뭘 테스트할지 몰라서 예제 테스트 하나만 남겨둔 채 방치하거나

대원칙: 사용자 여정(User Journey) 중심

E2E 테스트의 핵심은 사용자 관점이다. 코드가 아닌, 사용자가 서비스에서 수행하는 업무 흐름을 기준으로 시나리오를 정한다.

GOOD: "대시보드에 진입하면 주요 지표가 표시된다"
GOOD: "목록에서 항목을 클릭하면 상세 정보가 나타난다"

BAD:  "API가 200을 반환한다" (→ API 테스트 영역)
BAD:  "버튼 색상이 파란색이다" (→ 시각적 회귀 테스트 영역)

선정 기준 체크리스트

Must-Have: 반드시 테스트해야 하는 것

Should-Have: 테스트하면 좋은 것

시나리오 유형별 분류

유형 1: Smoke Test (연기 테스트)

"모든 페이지가 최소한으로 동작하는가?"

가장 기본적이면서 가장 가성비가 높은 테스트.

const pages = [
  { path: '/dashboard', name: '대시보드' },
  { path: '/users', name: '사용자 관리' },
  { path: '/settings', name: '설정' },
]

for (const { path, name } of pages) {
  test(`${name} 페이지가 로드된다`, async ({ page }) => {
    await page.goto(path)
    await expect(page).toHaveURL(new RegExp(path))
    await expect(page.getByRole('navigation')).toBeVisible()
  })
}

Smoke Test는 가장 먼저 작성해야 할 테스트다. 5-10개의 Smoke Test만으로도 배포 후 치명적인 문제를 조기에 발견할 수 있다.

유형 2: Happy Path (정상 흐름)

"핵심 업무 흐름이 정상 동작하는가?"

유형 3: Navigation & Routing (네비게이션)

"페이지 이동과 URL 라우팅이 정상 동작하는가?"

유형 4: Form Workflow (폼 워크플로우)

"폼 입력 → 유효성 검증 → 제출 → 결과 확인이 동작하는가?"

유형 5: Guard & Permission (가드/권한)

"접근 제어와 권한 체계가 올바르게 동작하는가?"

우선순위 매트릭스

추천 구현 순서

Phase 1: Smoke Test → Phase 2: 네비게이션 & 가드 → Phase 3: Happy Path → Phase 4: 폼 & 인터랙션

Phase 1만 완성해도 배포 안정성이 크게 올라간다.

실전 팁: "이건 E2E로 테스트하지 마세요"

시나리오 작성 템플릿

import { test, expect } from '@playwright/test'

test.describe('[기능명]', () => {
  // Smoke: 페이지 로드 확인 (P0)
  test('[기능] 페이지가 정상적으로 로드된다', async ({ page }) => {
    await page.goto('/[feature-path]')
    await expect(page).toHaveURL(/[feature-path]/)
    await expect(
      page.getByRole('heading', { name: /[페이지 제목]/i })
    ).toBeVisible()
  })

  // Happy Path: 핵심 인터랙션 (P1)
  test('[동작]하면 [결과]한다', async ({ page }) => {
    await page.goto('/[feature-path]')
    await page.getByRole('button', { name: /[동작]/i }).click()
    await expect(page.getByText('[기대 결과]')).toBeVisible()
  })
})

마치며

정리하면:

1. Smoke Test부터 시작하라
2. 크리티컬 패스에 집중하라
3. 점진적으로 확장하라
4. 테스트 피라미드를 존중하라

"모든 것을 테스트하는 것"이 아니라, **"가장 중요한 것을 확실히 테스트하는 것"**이 E2E 테스트 전략의 핵심이다.