playwright-cli — 터미널 명령으로 웹 화면을 테스트하고 캡처하기
마이크로소프트 Playwright 팀의 명령어 도구로, 브라우저 열기·클릭·입력·캡처·녹화를 한 줄 명령으로 합니다.
playwright-cli 는 마이크로소프트의 웹 테스트 도구 Playwright를 터미널 명령 한 줄씩 으로 다루게 해 주는 스킬입니다. AI가 브라우저를 열고, 화면 구조(스냅샷)를 읽고, 요소 번호로 클릭·입력한 뒤 캡처까지 남깁니다. 우리 작업 폴더에서는 격리된 웹 점검·폼 테스트 용으로 씁니다.
언제 쓰나
만든 사이트의 가입·로그인 폼이 제대로 동작하는지 확인할 때
여러 화면 크기에서 캡처를 남겨 비교할 때
점검 과정을 동영상이나 추적 기록으로 남기고 싶을 때
어떻게 부르나
playwright-cli로 우리 사이트 로그인 화면을 열고
이메일 칸에 테스트 주소를 넣어 제출한 뒤 캡처해 줘.
실제로 하는 일
playwright-cli open https://example.com/
playwright-cli snapshot
playwright-cli fill e5 "user@example.com" --submit
playwright-cli screenshot --filename=page.png
playwright-cli close
open 으로 브라우저를 열고 페이지로 갑니다.
snapshot 으로 화면 구조를 받습니다. 요소마다 e5 같은 번호가 붙습니다.
click , fill , press 로 조작합니다. --submit 을 붙이면 입력 후 Enter까지 누릅니다.
screenshot 으로 캡처하고 close 로 닫습니다.
그 밖에 resize 1920 1080 (창 크기), state-save auth.json (로그인 상태 저장), video-start · video-stop (녹화), tracing-start · tracing-stop (추적 기록) 같은 명령이 있습니다.
잘 쓰는 요령
캡처보다 스냅샷이 가볍고 정확합니다. 눈으로 확인할 때만 캡처하세요.
점검마다 새 세션을 만들고, 다른 사람이 쓰는 브라우저 세션을 한꺼번에 닫는 명령은 쓰지 않습니다.
내 계정으로 로그인해야 하는 개인 작업은 화면이 보이는 ego-browser가 먼저입니다.
테스트 코드를 몰라도, 한 줄 명령으로 웹 화면을 확인할 수 있습니다.