피드로 돌아가기
Testing Email Workflows Without Email Server — With Playwright & Mokapi
Dev.toDev.to
DevOps

Mokapi SMTP Mocking을 통한 E2E 이메일 워크플로우 검증 자동화

Testing Email Workflows Without Email Server — With Playwright & Mokapi

Maesi2026년 6월 5일3intermediate

Context

SMTP 서버의 비결정적 특성으로 인한 이메일 전송 결과 확인의 어려움 존재. 기존의 단순 함수 호출 Assert 방식은 실제 메일 내용 및 HTML 렌더링 결과 검증이 불가능한 한계 보유.

Technical Solution

  • 실제 SMTP 서버를 대체하는 Mokapi 기반의 Mock SMTP Server 구축
  • Backend 시스템이 표준 SMTP 프로토콜을 통해 메시지를 전송하면 Mokapi가 이를 캡처하여 내부 저장소에 유지
  • Playwright Test Suite 내에서 Mokapi HTTP API를 호출하여 캡처된 이메일 본문 및 메타데이터를 JSON 형태로 추출
  • 런타임마다 Random Email을 생성하여 테스트 케이스 간의 데이터 격리(Isolation) 확보
  • 개발 단계의 레이아웃 검증을 위해 IMAP 프로토콜을 지원하여 실제 메일 클라이언트 연동 구조 설계
  • Browser Automation과 API Assertion을 단일 테스트 스크립트로 통합하여 검증 파이프라인 단순화

- 외부 의존성이 있는 Third-party 서비스는 HTTP API 기반의 Mock 서버로 대체하여 테스트 결정성 확보 - E2E 테스트 시 Random Identifier를 도입하여 테스트 간 상태 간섭 방지 - 자동화된 Assertion 외에 시각적 검증이 필요한 경우 IMAP 등 표준 프로토콜 지원 도구 검토

원문 읽기