Playwright 공식 문서는 Chromium, WebKit, Firefox를 지원한다고 설명합니다. 따라서 Playwright Safari 테스트는 WebKit으로 먼저 자동 검사하되, WebKit은 Safari 자체가 아니므로 실제 Safari 결과가 필요하면 macOS에서 따로 확인해야 합니다.
윈도우에서 웹 수업 프로젝트를 만들고 브라우저 검사를 추가하려는 학생에게 적합합니다. Safari에서만 보이는 화면이나 동작 문제가 의심되는 초보자도 확인 절차를 따라갈 수 있습니다. 수업에 브라우저별 결과를 제출해야 한다면, 자동 검사와 실제 브라우저 확인을 구분하는 데 활용하세요.
테스트 결과의 용도부터 정합니다
먼저 제출해야 할 결과가 무엇인지 확인하세요. 페이지가 열리는지, 버튼이나 메뉴가 작동하는지 확인하는 것과 실제 Safari에서의 모습을 입증하는 일은 서로 다릅니다. 자동화 테스트는 사람이 직접 누르던 작업을 자동으로 실행하고 결과를 확인하는 방식입니다. 기대한 결과와 실제 화면이 맞는지 살피는 검사는 자동 채점에 비유할 수 있습니다.
| 확인하려는 결과 | 먼저 사용할 방법 | 결과가 말해 주는 것 |
|---|---|---|
| 페이지가 열리고 핵심 화면이 보이는지 | Playwright WebKit 테스트 | WebKit 환경에서 정한 검사가 통과했는지 |
| 기본 입력과 버튼이 작동하는지 | Playwright WebKit 테스트 | 작성한 동작과 확인 조건이 맞았는지 |
| Safari에서 글꼴이나 미디어가 실제로 어떻게 보이는지 | macOS의 Safari에서 직접 확인 | 해당 환경에서 수행한 실제 브라우저 확인 결과 |
| 수업에서 Safari 사용 결과를 요구하는지 | 요구사항에 맞춰 macOS에서 재검증 | 제출할 화면, 조작, 결과를 직접 확인했는지 |
윈도우에서는 WebKit으로 자동 초안을 확인합니다
윈도우에서도 Safari 호환성을 확인할 수 있나요? 윈도우에서 Playwright를 설치하고 WebKit 테스트를 실행할 수 있습니다. 이는 Safari 자체의 검증이 아니라, WebKit을 대상으로 한 자동화 검사입니다. 화면이 열리는지와 기본 상호작용이 작동하는지 먼저 살펴보는 초안으로 사용하세요. Playwright의 설치 안내와 운영체제 요구사항은 현재 환경에 맞는 설치 방법을 확인할 때 기준으로 삼을 수 있습니다.
프로젝트에서 실행할 수 있는 스크립트나 패키지 관리 방식은 다를 수 있습니다. 아래 명령은 일반적인 시작 예시이므로, 설치 도중 선택 항목과 현재 공식 문서를 함께 확인하세요.
npm init playwright@latest설치 과정에서 사용할 언어와 테스트 폴더를 정하고 브라우저를 설치합니다. 기존 프로젝트에 추가할 때는 도구가 제안하는 기본 설정을 그대로 덮어쓰기 전에 변경 내용을 살펴보세요. 프로젝트 실행 방법도 확인해 둡니다. 테스트만 실행했을 때 개발 서버가 자동으로 켜지는 프로젝트가 아니라면, 먼저 별도 터미널에서 서버를 실행해야 합니다.
npx playwright test --project=webkit공식 테스트 실행 안내에 따라 프로젝트 이름을 확인한 뒤 WebKit만 선택합니다. 브라우저 프로젝트 이름은 설정에 따라 달라질 수 있으니, 명령이 프로젝트를 찾지 못하면 설정 파일에 지정한 이름을 확인하세요. 브라우저별 실행 대상을 나누는 방법은 테스트 프로젝트 설정 문서에서 볼 수 있습니다.
| 검사 방식 | 윈도우에서 가능 | 실제 Safari 확인 | 적절한 쓰임 |
|---|---|---|---|
| Playwright WebKit 자동 테스트 | 가능 | 아님 | 페이지 열림과 정해 둔 기본 동작 검사 |
| macOS Safari에서 직접 확인 | 윈도우만으로는 불가 | 가능 | Safari 화면과 동작을 제출해야 할 때 |
| WebKit 통과 기록만 제출 | 가능 | 입증하지 못함 | 자동화 초안의 결과를 보고할 때 |
실패 결과는 테스트와 페이지를 나눠 추적합니다
WebKit 테스트가 실패했다고 바로 Safari 결함이라고 판단하지 마세요. 테스트 코드가 잘못된 요소를 찾거나, 페이지가 준비되기 전에 동작을 실행했거나, 예상 결과를 실제 동작과 다르게 적었을 수도 있습니다. 아래 순서로 원인을 좁히세요.
- 같은 프로젝트에서 실패한 테스트를 다시 실행하고, 오류 메시지와 실패 위치를 기록합니다.
- 실패한 화면이 실제로 열렸는지 확인합니다. 개발 서버 주소, 로딩 상태, 콘솔 오류를 살펴봅니다.
- 버튼이나 입력창을 찾는 조건을 확인합니다. Playwright 위치 찾기 안내의 권장 방식을 참고해 요소가 실제 페이지에 있는지 대조하세요.
- 테스트가 기대한 값을 다시 확인합니다. 화면에 표시되는 글자나 이동 주소와 검사 조건이 같은지 비교하고, 검증 조건 안내를 참고합니다.
- 클릭이나 입력이 실패했다면 요소가 보이고 조작 가능한 상태였는지 살펴봅니다. Playwright는 동작 전에 자동 확인을 수행하므로, 자동 대기와 조작 가능 조건을 확인하면 준비 시간 문제와 테스트 조건 문제를 구분하는 데 도움이 됩니다.
- 같은 코드와 같은 테스트를 Chromium과 WebKit에서 각각 실행하고 결과를 나란히 기록합니다. 한쪽에서만 실패한 경우에도, 원인은 오류 기록으로 확인하기 전까지 단정하지 않습니다.
주의: WebKit 스크린샷이나 테스트 통과 보고서는 WebKit 검사 결과입니다. 이를 실제 Safari 화면을 캡처하거나 Safari에서 테스트한 결과라고 표현하지 마세요.
실제 Safari 재검증 여부는 조건으로 결정합니다
실제 Safari에서 다시 확인해야 하는 때는 언제인가요? 수업이나 프로젝트가 Safari에서 수행한 결과를 요구하거나, WebKit 검사만으로 해소되지 않는 화면·글꼴·미디어 차이가 있다면 macOS Safari에서 확인하세요. 반대로 과제가 자동화 테스트의 실행 결과만 요구한다면, WebKit 결과를 정확히 표시하고 Safari 검증으로 오해되지 않도록 제출하면 됩니다.
다음 조건 목록에서 해당하는 갈래를 선택하세요.
- 과제가 “Safari에서 확인”한 화면과 동작을 요구하면, macOS Safari에서 직접 재검증하고 브라우저 이름을 기록합니다. WebKit 결과만으로 대체하지 않습니다.
- 페이지 열림과 기본 조작의 자동 검사가 목표라면, 윈도우에서 WebKit 테스트를 먼저 실행하고 결과를 WebKit 검사로 제출합니다.
- WebKit만 실패하고 다른 브라우저에서는 통과한다면, 로그와 테스트 조건을 확인한 뒤 macOS Safari에서 재현되는지 확인합니다. 실패 원인을 확인하기 전에는 Safari 버그로 단정하지 않습니다.
- 글꼴 모양이나 미디어 재생처럼 기기와 운영체제에 영향을 받을 수 있는 결과가 핵심이면, 자동 검사에만 의존하지 말고 실제 Safari 환경에서 관찰 내용을 기록합니다.
- 사용할 수 있는 Mac이 없지만 실제 Safari 결과가 필수라면, 학교에서 허용하는 Mac 환경을 먼저 확인합니다. 그 방법이 어렵다면 과제 규정상 원격 macOS 사용이 가능한지 담당자에게 확인한 뒤 선택합니다.
제출할 때는 실행 조건과 관찰 결과를 함께 남깁니다
기록에는 확인한 페이지, 실행한 조작, 결과를 구분해 적으세요. 예를 들면 “WebKit에서 상품 목록을 열고 메뉴를 눌렀으며 메뉴가 표시됨”처럼 환경과 행동, 관찰 결과를 한 문장에 담습니다. 실제 Safari를 확인했다면 사용한 브라우저와 macOS 환경도 밝혀야 합니다. 확인하지 않은 버전이나 기기 정보를 채워 넣지 말고, 모르면 기록에서 제외하세요.
여기서 중요한 구분은 자동 검사의 범위와 제출물의 주장 범위입니다. Playwright가 검사한 것은 테스트에 작성한 페이지와 동작입니다. 테스트에 포함하지 않은 반응형 배치나 미디어 동작까지 확인했다고 볼 수 없습니다. Safari에서 직접 보지 않았다면 “Safari에서 정상 작동” 대신 “Playwright WebKit 테스트 통과”라고 작성하세요.
Safari를 따로 확인해야 할 때 Mac이 없는 학생은 학교 컴퓨터 이용 시간에 맞추느라 재현을 미루거나, WebKit 결과를 Safari 결과로 잘못 제출할 위험이 있습니다. 반면 Mac을 바로 구매하는 방식은 실제 Safari를 반복해서 확인할 필요가 적은 학생에게 초기 지출이 부담이 될 수 있습니다. 실제 브라우저 확인이 과제 요건일 때만 macOS 환경을 마련하고, 다른 브라우저 검사는 윈도우의 자동화로 이어가는 편이 낭비를 줄입니다.
학교의 이용 규칙이 허용하고 실제 Mac 확인이 필요한 기간에만 원격 macOS를 선택할 수도 있습니다. MACGPU의 Mac 환경 이용 안내에서 접속 방식을 살펴보고, 원격 Mac 환경을 이용할지 학교 컴퓨터나 직접 보유한 Mac을 쓸지 비교하세요. 과제에서 원격 환경을 허용하는지 먼저 확인하고, 결과에는 실제로 실행한 브라우저와 관찰 내용만 적으면 됩니다.