웹 앱 테스팅

UI 검증 및 디버깅을 위해 Playwright를 사용한 로컬 웹 애플리케이션 테스트

Home/Developer Tools/웹 앱 테스팅

What is it?

Playwright를 사용하여 로컬 웹 애플리케이션과 상호 작용하고 테스트하기 위한 툴킷입니다. 프론트엔드 기능 검증, UI 동작 디버깅, 브라우저 스크린샷 캡처, 브라우저 로그 보기를 지원합니다. 이 스킬은 효과적인 브라우저 자동화를 위한 정찰-후-행동 패턴을 강조하며 서버 수명 주기를 관리하기 위한 헬퍼 스크립트를 제공합니다.

How to use it?

테스트는 애플리케이션 유형에 따라 의사 결정 트리를 따릅니다:

정적 HTML의 경우:

  • HTML 파일을 직접 읽어 선택자 식별
  • 발견된 선택자를 사용하여 Playwright 스크립트 작성
  • 불완전한 경우 동적으로 처리

동적 웹 앱의 경우:

  1. 서버가 실행 중이지 않은 경우 - scripts/with_server.py를 사용하여 서버 수명 주기 관리:

    python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_test.py
    

    다중 서버 지원 (예: 백엔드 + 프론트엔드)

  2. 정찰-후-행동 패턴:

    • 탐색하고 networkidle 대기 (동적 앱에 중요)
    • 스크린샷 찍기 또는 DOM 검사
    • 렌더링된 상태에서 선택자 식별
    • 발견된 선택자로 작업 실행

핵심 패턴:

page.goto('http://localhost:5173')
page.wait_for_load_state('networkidle')  # JS 실행 대기
page.screenshot(path='/tmp/inspect.png')  # 먼저 검사
# 그런 다음 작업 수행

Key Features

  • 완전한 JavaScript 지원을 갖춘 Playwright 기반 브라우저 자동화
  • 서버 수명 주기 관리 - 헬퍼 스크립트가 서버 시작/중지 처리
  • 다중 서버 지원 - 백엔드 + 프론트엔드를 동시에 실행
  • 정찰-후-행동 패턴 - 행동하기 전에 검사
  • 시각적 디버깅 및 검증을 위한 스크린샷 캡처
  • JavaScript 문제 디버깅을 위한 콘솔 로그 캡처
  • 요소 발견 헬퍼 - 동적 페이지에서 버튼, 링크, 입력 찾기
  • file:// URL을 통한 정적 HTML 자동화 지원
  • CI/CD 통합을 위한 헤드리스 모드
View on GitHub

GitHub Stats

Stars
Forks
Last Update
Author
Anthropic
License
Apache-2.0
Version
1.0.0

Categories

Features

⭐ Featured
💻 Code Execution