E2E 테스트
규칙
- E2E에는 Playwright 사용 — 크로스 브라우저, 자동 대기, 내장 테스트 러너, 우수한 CI 지원
- 로케이터 우선순위:
getByRole() > getByLabel() > getByPlaceholder() > getByTestId() > CSS 선택자
- 페이지 객체 모델: 페이지 상호작용을 클래스로 캡슐화 —
LoginPage.login(email, password)
- 테스트 격리: 각 테스트는 새로운 상태에서 시작 — 설정에는
beforeEach 사용, 테스트 간 의존성 금지
- 자동 대기: Playwright가 요소를 자동으로 기다림 — 수동
waitForTimeout() 호출 금지
- 단언문:
expect(locator) 웹 우선 단언문 사용 — toBeVisible(), toHaveText(), toHaveURL()
- 병렬 실행: 기본적으로 테스트가 병렬로 실행됨 — 테스트 간 공유 가능한 변경 상태 없어야 함
- CI: 헤드리스 모드 실행, 재시도 구성(CI에서
retries: 2), 실패 시 Trace 업로드
- 시각적 회귀 테스트:
expect(page).toHaveScreenshot() — --update-snapshots로 기준 스냅샷 업데이트
패턴
class LoginPage {
constructor(private page: Page) {}
async goto() { await this.page.goto("/login"); }
async login(email: string, password: string) {
await this.page.getByLabel("Email").fill(email);
await this.page.getByLabel("Password").fill(password);
await this.page.getByRole("button", { name: "Sign in" }).click();
await this.page.waitForURL("/dashboard");
}
}
export default defineConfig({
retries: process.env.CI ? 2 : 0,
use: { trace: "on-first-retry", screenshot: "only-on-failure" },
projects: [
{ name: "chromium", use: { ...devices["Desktop Chrome"] } },
{ name: "mobile", use: { ...devices["Pixel 5"] } },
],
});
피해야 할 것
page.waitForTimeout() — 자동 대기 또는 waitForURL(), waitForResponse() 사용
- 상호작용 요소에 CSS 선택자 사용 — role 기반 로케이터를 사용하여 안정성 확보
- 다른 테스트의 상태에 의존하는 테스트 — 각 테스트는 독립적으로 실행 가능해야 함
- 제3자 서비스 직접 테스트 —
page.route()로 외부 API 모킹
- 모바일 뷰포트 생략 — 프로젝트 매트릭스에 최소 하나의 모바일 기기 테스트 포함