Playwright로 Safari 테스트: Linux면 충분할까, 원격 Mac이 필요할까? 2026
📋 목차
Linux CI에서 WebKit 테스트는 통과했지만 Safari 회귀 검수가 승인되지 않습니다. 일반적인 사전 검사는 Linux의 Playwright WebKit으로 진행하고, 실제 Safari 승인이나 macOS에서 확인해야 할 동작은 Mac의 Safari WebDriver 작업으로 분리하세요. 로컬 Mac이 없다면 원격 Mac을 실행 환경 후보로 검토할 수 있습니다.
이 글은 테스트 실행 위치를 정해야 하는 웹 개발자, QA 엔지니어, CI 엔지니어를 위한 안내입니다. WebKit 엔진 검사와 실제 Safari 검수를 구분하고, Mac 작업이 필요한 조건과 결과를 남기는 방법을 다룹니다.
Linux WebKit 사전 검사와 실제 Safari 검수
Playwright WebKit은 WebKit 프로젝트의 브라우저를 바탕으로 하지만, 브랜드가 적용된 Safari 브라우저 자체는 아닙니다. Playwright는 Linux에서 WebKit을 CI에 사용할 수 있다고 안내합니다. 따라서 일반적인 교차 브라우저 사전 검사에는 쓸 수 있어도, 그 결과를 특정 Safari 버전의 승인 근거로 바꾸면 안 됩니다. Playwright의 브라우저 및 WebKit 안내를 기준으로 프로젝트에서 사용하는 버전과 실행 환경을 확인하세요.
| 실행 선택지 | 알맞은 목적 | 실제 Safari 검수 | 운영상 판단 |
|---|---|---|---|
| Linux의 Playwright WebKit | 일반적인 브라우저 엔진 사전 검사 | 수행하지 않음 | Linux CI에 남겨 공통 검사로 활용 |
| Mac의 Playwright WebKit | Mac 환경에서 WebKit 동작을 추가 확인 | Safari 자체 검수는 아님 | macOS에서만 드러나는 차이가 의심될 때 검토 |
| Mac의 Safari WebDriver | 실제 Safari에서 회귀와 승인 조건 확인 | 수행 가능 | Safari가 승인 대상일 때 별도 작업으로 구성 |
| 실제 iPhone 또는 iPad의 Safari | 실제 기기의 브라우저와 입력 환경 확인 | 기기에서 수행 | 기기 연결과 권한을 별도 검증 |
이 표의 적합도는 테스트 목적을 기준으로 한 선택 가이드입니다. 실행 환경의 세부 지원 여부는 사용 중인 Playwright, macOS, Safari 문서를 함께 확인해야 합니다.
WebKit 근접 동작과 미디어 검증
Safari에 가까운 동작을 빠르게 살피는 것과 실제 Safari 출시 검수를 하는 것은 서로 다른 일입니다. Playwright 문서는 Mac에서 WebKit을 실행하면 Safari에 더 가까운 결과를 확인할 수 있다고 설명하지만, 이것도 실제 Safari 검수와 같다는 뜻은 아닙니다. Playwright 브라우저 문서에서 WebKit과 Safari의 관계를 확인한 뒤, 승인 기준에 맞게 테스트 이름과 결과를 구분하세요.
미디어 재생처럼 플랫폼 차이가 영향을 줄 수 있는 기능은 Linux WebKit 결과만으로 판정을 끝내지 마세요. 우선 기존 Linux 작업에서 오류를 빠르게 찾고, 문제가 재현되거나 실제 Safari 동작이 승인 조건이면 Mac에서 WebKit을 추가 확인하거나 Safari WebDriver 검수를 별도로 실행합니다.
주의: 테스트 보고서에서 WebKit 결과를 Safari 결과로 표기하지 마세요. 어떤 엔진과 브라우저, 운영체제에서 실행했는지 분리해 두어야 실패 원인과 승인 범위를 혼동하지 않습니다.
실제 Safari 데스크톱 회귀
대상 브라우저가 Apple Safari라면 macOS에서 Safari를 실행하는 경로가 필요합니다. Apple은 Safari에서 WebDriver 자동화를 지원하며, 실행 전 자동화 사용 설정과 safaridriver 실행 조건을 확인하도록 안내합니다. Apple의 Safari WebDriver 설명과 Safari WebDriver 테스트 안내를 기준으로 환경을 준비하세요.
역할은 다음처럼 나뉩니다.
- 테스트 클라이언트는 WebDriver 명령을 만들어 테스트 흐름을 실행합니다.
- safaridriver는 WebDriver 요청을 Safari 자동화에 연결합니다.
- Safari 브라우저 인스턴스는 실제 페이지를 열고 상호작용을 수행합니다.
WebDriver는 브라우저 자동화 명령을 주고받기 위한 표준입니다. 구체적인 세션 생성과 브라우저 상호작용의 책임은 W3C WebDriver 규격에서 확인할 수 있습니다. 다만 표준을 따른다는 사실만으로 원격 Mac의 권한 설정이나 팀의 CI 연동이 자동으로 끝나는 것은 아닙니다. 실행 계정, 자동화 허용 상태, 브라우저 실행 여부를 실제 환경에서 점검해야 합니다.
모바일 화면 모사와 실제 기기 검수
Playwright의 기기 모사는 뷰포트와 기기 특성에 맞춘 브라우저 설정을 시험하는 데 유용합니다. 그러나 이 결과는 iPhone이나 iPad에서 실제로 실행한 Safari 테스트가 아닙니다. Playwright의 기기 모사 문서는 모사할 수 있는 설정의 범위를 설명합니다. 이를 실제 기기 검수와 구분해 결과에 기록하세요.
실제 iOS 또는 iPadOS Safari가 승인 대상이면 연결할 기기, Mac, 시스템 권한과 팀의 기존 테스트 시설을 각각 확인해야 합니다. Apple의 iOS WebDriver 사용 설정 안내를 참고해 지원 조건을 검토하세요. 기기 연결이나 권한을 확인하지 않은 상태에서 데스크톱 Safari 결과를 모바일 승인으로 확대 해석하지 마세요.
점검 메모: 모사 테스트는 반응형 화면과 일반적인 상호작용을 미리 확인하는 데 두고, 실제 기기 검수는 승인 조건이 요구할 때 별도 작업으로 유지하세요.
테스트 목적별 실행 환경 판단 FAQ
Playwright WebKit 테스트와 Safari 테스트는 어떻게 다른가요?
Playwright WebKit은 WebKit을 대상으로 자동화하는 브라우저 테스트이며, Apple Safari라는 제품 브라우저를 실행하는 테스트와 같지 않습니다. 엔진 수준의 사전 검사는 WebKit으로 진행할 수 있지만, Safari의 특정 버전에서 발생하는 동작이나 출시 승인 기준을 확인하려면 해당 Safari를 실행하는 macOS 환경에서 별도로 검수해야 합니다.
Linux에서 통과한 WebKit 테스트를 Safari 호환성 근거로 써도 되나요?
그 결과만으로 실제 Safari 호환성을 보증할 수는 없습니다. Playwright 문서는 Linux에서 WebKit을 CI에 사용할 수 있다고 안내하지만, Safari 자체를 대신한다고 설명하지는 않습니다. 테스트 기록에는 사용한 브라우저 엔진과 실행 환경을 남기고, Safari 지원이 승인 조건이라면 macOS의 Safari WebDriver 작업을 별도 게이트로 두세요.
Safari WebDriver를 원격 Mac CI 작업에 연결할 수 있나요?
Safari WebDriver는 Safari 자동화를 위한 경로이며, 테스트 클라이언트가 WebDriver 명령을 전달하고 safaridriver가 Safari와의 자동화 연결을 맡습니다. 따라서 macOS에서 실행되는 작업에 붙이는 구성을 검토할 수 있습니다. 다만 원격 접속만 된다고 자동화가 준비된 것은 아니므로, 해당 Mac의 Safari 버전과 자동화 권한, 실행 계정, 결과 회수 경로를 먼저 확인해야 합니다.
어떤 Safari 검수는 macOS에서 실행해야 하나요?
실제 Safari 버전에서의 레이아웃, 입력 처리, 브라우저별 회귀를 승인해야 한다면 macOS에서 Safari를 실행해 확인해야 합니다. 미디어 재생처럼 운영체제나 브라우저 통합에 영향을 받을 수 있는 동작도 WebKit 결과만으로 승인하지 말고 Mac에서 재검수하세요. iPhone이나 iPad용 Safari가 대상이면 데스크톱 Safari와 화면 크기 모사를 실제 기기 테스트로 간주하지 마세요.
혼합 CI에서 Linux와 Mac 작업 나누기
일반적인 WebKit 검사는 현재 Linux CI에 두고, 실제 Safari 승인이 필요한 프로젝트만 macOS 작업을 추가하는 구성이 기본 선택입니다. 모든 테스트를 Mac으로 옮기기보다 승인 조건과 재현 요구를 기준으로 분리하세요.
아래 조건에 따라 실행 위치를 결정합니다.
- WebKit 엔진에서 자주 발견되는 오류를 합병 전에 확인하려면 Linux 작업을 유지합니다.
- 실제 Safari 버전에서의 동작이 출시 승인에 포함되면 macOS Safari WebDriver 작업을 추가합니다.
- iPhone 또는 iPad Safari가 승인 대상이면 실제 기기와 연결 권한을 별도 점검합니다.
- Safari 버전별 결과를 다시 만들 수 있어야 한다면 브라우저와 macOS 환경 정보를 테스트 결과에 함께 남깁니다.
- Mac 작업의 운영 담당자, 장애 시 재실행 방법, 결과 보존 위치를 정하지 못했다면 전체 파이프라인에 넣기 전에 대표 테스트로 검증합니다.
CI에서 브라우저와 실행 이미지를 준비하는 방식은 프로젝트에 따라 다릅니다. Playwright의 CI 안내를 참고하되, Safari WebDriver 작업의 구성은 Apple 문서와 실제 Mac 환경에서 별도로 확인하세요.
Mac Safari 작업을 넣기 전 실행 확인
본격적으로 파이프라인을 바꾸기 전에 작은 테스트 흐름으로 아래 항목을 순서대로 확인합니다.
- 승인 대상이 WebKit 엔진인지, 실제 Safari인지, 실제 모바일 기기인지 테스트 요구사항에 표시합니다.
- Linux 작업의 브라우저와 Playwright 버전을 기록하고, 현재 검사가 해당 환경에서 계속 실행되는지 확인합니다.
- Safari가 필요하면 대상 macOS 환경에서 Safari와 safaridriver의 사용 가능 여부를 확인합니다.
- Apple 안내에 따라 Safari 자동화 권한을 설정하고, 테스트 계정에서 브라우저 세션을 열 수 있는지 확인합니다.
- 로그인, 핵심 화면 전환, 승인에 중요한 상호작용을 포함한 대표 테스트를 실행합니다.
- 결과에 커밋, 실행 환경, 브라우저 정보, 실패 화면이나 로그를 함께 보존합니다.
- 로컬 재현과 CI 재실행이 모두 가능하면 작은 범위부터 정기 작업에 포함합니다.
테스트 실패만 저장하면 나중에 Safari 회귀인지, 권한 문제인지, 실행 환경 변경인지 가리기 어렵습니다. 실행 환경의 기록과 실패 증거를 함께 남기는 것은 공식 문서에 적힌 기능 설명과 별개로, 운영자가 다음 조치를 정하는 데 필요한 팀의 검증 절차입니다.
원격 Mac을 추가할 시점
Linux WebKit의 장점은 기존 CI 흐름에서 일반적인 사전 검사를 이어갈 수 있다는 점입니다. 반면 Linux 작업만으로는 실제 Safari 브라우저를 검수할 수 없고, Safari 특정 버전을 기준으로 한 승인 증거도 만들 수 없으며, macOS에서 확인해야 하는 동작을 재현하는 데 한계가 있습니다.
프로젝트가 정기적으로 실제 Safari 승인을 요구하지만 팀에 로컬 Mac이 없다면, 원격 Mac은 Mac 기반 실행 환경 후보가 될 수 있습니다. 실제 Mac 하드웨어와 가상화 환경의 차이가 운영 조건에 영향을 준다면 Mac 하드웨어와 가상화 방식 비교도 함께 검토하세요. Safari 실행 가능 여부, 자동화 권한, 브라우저 버전 확인, 로그와 결과 회수 방식을 먼저 검증해야 합니다. MacDate의 macOS 환경 안내를 살펴보고, 대표 테스트가 통과하는지 확인한 뒤 CI 실행 위치를 정하세요. 장기간 계속되는 무거운 작업이나 물리 기기 연결이 핵심 조건이라면 원격 실행이 맞는지 먼저 따져보고, 자체 Mac이나 기존 기기 테스트 시설과 비교하는 편이 안전합니다.