Playwright · 02 설정과 실행 범위
단계: 사용자 흐름과 Locator · 외부 실행 예제 · 미리보기 안내 · 저장 ID: playwright-step-02
목표와 학습 후 역량
- 학습 결과: Runner의 역할을 설명한다. 입력 사례: 별도 로컬 테스트 origin.
- 산출물: 실행 명령·대상 URL·리포트. BaseURL 처리 근거를 코드와 연결해 설명한다.
선수 지식
1단위 「사용자 관점의 테스트」의 사용자 계약 및 자동 대기 실습 결과를 준비한다.
핵심 개념과 설명
Runner
Playwright Test는 Node에서 브라우저를 제어한다. iframe의 예제 표시가 테스트 실행을 뜻하지 않는다.
BaseURL
테스트 origin을 명시하면 실제 사용자 데이터와 분리하기 쉽다. 앱 서버와 테스트 runner의 역할은 다르다.
실습 준비
예제 화면의 실행 범위 안내를 먼저 확인하세요. 다음은 과제를 별도 프로젝트로 확장할 때의 준비 환경입니다. 모든 테스트는 별도 Node 프로젝트의 @playwright/test와 테스트 전용 로컬 origin에서 작성·실행한다. 기존 playwright-01·02·03 미리보기는 테스트 소스를 보여줄 뿐 iframe에서 Playwright를 실행하지 않는다. 새 테스트 파일은 과제에서 직접 작성하며 통과 여부는 실제 runner 출력으로만 판단한다. 사용자 profile·실사용 저장소를 사용하지 않고 CSP·격리를 유지한다.
연결된 예제는 출발점입니다. 아래 과제 전체가 완성된 코드는 아니며, 예제의 지원 범위를 넘는 작업은 별도 프로젝트에서 수행하세요.
실습 과제
- 별도 실습 프로젝트의 tests/day-2.spec.ts에 playwright.config.ts에 baseURL·testDir를 설정하고 npx playwright test를 실행한다. 기존 1·14·28단위 예제는 출발점으로만 참고한다.
- 입력 조건: 별도 로컬 테스트 origin. 기준: 정상 서버. 기준 조건에서 실행한 뒤 관찰값과 오류를 notes/day-2.md에 남긴다.
- 변경 변수: URL. 변경값: 꺼진 서버. 같은 입력 경로로 다시 실행한다. 저장할 산출물: 실행 명령·대상 URL·리포트. 확인할 가설: 서버 실패를 테스트 실패 원인으로 구분한다. 실제 결과와 비교해 일치 여부 및 차이의 원인을 기록한다.
관찰할 변수
| 변수 | 기준 조건 | 바꿀 조건 | 예상할 변화·검증 가설 |
|---|---|---|---|
| URL | 정상 서버 | 꺼진 서버 | 서버 실패를 테스트 실패 원인으로 구분한다. |
표의 예상은 측정 결과가 아닙니다. 한 번에 한 조건만 바꾸고 실제 결과가 다르면 원인을 기록하세요.
완료 조건
- 필수 산출물: 실행 명령·대상 URL·리포트. 기준 및 변경 조건 각각의 결과가 있어 총 2조건을 비교할 수 있고, 입력값과 실행 환경을 함께 기록했다.
- 두 조건의 차이에 관한 설명에 다음 개념을 모두 연결했다: Runner, BaseURL. 예상과 다른 항목은 원인 또는 미해결 이유를 1개 이상 적었다.
자가 점검
- 이번 실습에서 Runner 개념은 어느 처리 단계에 영향을 주는가? 입력 사례: 별도 로컬 테스트 origin.
- 변경 변수: URL. 확인할 가설: 서버 실패를 테스트 실패 원인으로 구분한다. 실제 결과가 가설과 일치했는가? BaseURL 관점에서 근거를 설명하라.
공식 참고
- Playwright 설치와 실행
- Playwright Locators
- Playwright Assertions
- Playwright Downloads
- Playwright Visual comparisons
연결된 예제와 실행 범위
Runnable standalone Playwright spec and HTTP fixture; preview does not run tests.
원본 코드·기록은 자동으로 덮어쓰지 않습니다. 기존 예제를 초기화할 때도 필기는 유지됩니다.
다음 학습
이전: 사용자 관점의 테스트 · 다음: Role과 접근 가능한 이름