ChromeDriver

누가 사용하는 도구인가

로그인, 검색, 주문서 입력처럼 Chrome에서 반복 확인해야 하는 웹 기능을 코드로 검사하려는 개발자와 QA 담당자에게 적합합니다. 테스트 시나리오와 결과 판정은 Selenium 등의 클라이언트와 테스트 코드가 맡고, ChromeDriver는 브라우저 제어를 담당합니다. W3C WebDriver와 WebDriver BiDi 표준을 구현하며 Chromium 전용 설정도 제공합니다. [공식 제품 소개](https://developer.chrome.com/docs/chromedriver/)

macOS 지원과 버전 검토

공식 소개는 Mac·Linux·Windows·ChromeOS 및 Android의 Chrome 지원을 안내합니다. macOS 배포 파일은 Apple Silicon용 mac-arm64와 Intel용 mac-x64로 구분됩니다.

2026-10-09에 열린 공식 배포 대시보드의 Stable 버전은 155.0.8059.39였습니다. 제공된 152.0.7977.64를 최신 버전으로 소개해서는 안 됩니다. 현재 배포가 이어지고 있어 제품 전체를 지원 종료 프로그램으로 볼 근거는 확인되지 않았습니다. [공식 배포 현황](https://googlechromelabs.github.io/chrome-for-testing/)

설치 준비와 첫 작업 순서

먼저 사용할 Chrome과 Mac의 CPU 종류를 확인합니다. 수동 구성에서는 공식 배포 페이지에서 브라우저에 맞는 ChromeDriver를 선택하고 압축을 푼 뒤, 실행 파일 위치를 PATH 또는 클라이언트의 드라이버 경로 설정에 등록합니다. Chrome이 기본 위치에 없다면 ChromeOptions로 실제 실행 파일 경로를 지정합니다.

다음으로 선택한 언어의 Selenium 라이브러리에서 세션을 만들고, 테스트 페이지 열기→입력란 찾기→문자 입력과 제출→결과 확인→quit 호출 순서로 작은 테스트를 작성합니다. [공식 시작 안내](https://developer.chrome.com/docs/chromedriver/get-started)

실무에서 활용하는 방법

예를 들어 쇼핑몰 테스트 환경에서 상품명을 검색하고 결과 목록에 예상 상품이 나타나는지 검사할 수 있습니다. 검색창의 식별자와 기대 결과를 테스트 코드에 정하고, 화면 전환 후 결과 요소가 준비되었는지 확인하도록 구성합니다.

CSV 내려받기까지 검사한다면 전용 다운로드 폴더를 지정하고 파일 생성과 완료 상태를 확인한 뒤 세션을 종료해야 합니다. ChromeDriver는 다운로드 완료를 자동으로 기다리지 않습니다. 프로필은 기본적으로 세션마다 임시로 생성됩니다. [ChromeOptions 문서](https://developer.chrome.com/docs/chromedriver/capabilities)

무료 이용과 운영 제약

공식 ChromeDriver 배포 파일은 결제 없이 내려받을 수 있습니다. 확인한 공식 자료에서는 별도 유료판이나 무료판의 실행 횟수 제한을 찾지 못했습니다. Chromium 라이선스는 조건을 지키는 소스·바이너리 사용과 재배포를 허용하지만 무보증 조건도 명시합니다. [Chromium 라이선스](https://chromium.googlesource.com/chromium/src/+/main/LICENSE)

브라우저와 클라이언트 라이브러리는 별도로 필요합니다. 운영 시에는 기본 로컬 연결 설정을 유지하고, 원격 연결이 필요하면 허용 IP와 방화벽을 설정합니다. 공식 보안 문서는 민감한 데이터에 접근하지 못하는 테스트 계정 사용을 권고합니다.

오류가 발생했을 때 확인 순서

세션 생성에 실패하면 실제 Chrome 버전, 실행 중인 ChromeDriver 버전, PATH에 남은 다른 드라이버를 먼저 확인합니다. 브라우저가 시작되지 않으면 상세 로그에서 실행 파일 경로와 인수를 확인하고, 같은 Chrome을 일반 사용자 터미널에서 직접 실행해 봅니다. --verbose와 --log-path로 진단 정보를 남길 수 있습니다. [실행 문제 안내](https://developer.chrome.com/docs/chromedriver/help/chrome-doesnt-start)

클릭 오류는 대상 위에 다른 요소가 겹쳤는지, 고정 헤더에 가려졌는지, 애니메이션으로 위치가 움직이는지 순서대로 확인합니다. 움직이는 요소의 클릭 성공은 보장되지 않으므로 정지한 상태에서 검사하도록 테스트를 조정합니다.

다른 도구와 선택 기준

Selenium은 테스트 코드를 작성하는 상위 도구이고 ChromeDriver는 Chrome 제어를 맡으므로 함께 사용합니다. 드라이버 버전 관리 부담을 줄이려면 Selenium에 포함된 Selenium Manager를 검토할 수 있습니다. 드라이버를 따로 제공하지 않은 경우 필요한 버전을 탐색·다운로드·캐시하는 역할을 합니다. 버전을 고정해야 하는 환경은 수동 경로 지정도 선택할 수 있습니다. Firefox나 Edge 테스트에는 각각 해당 브라우저의 드라이버가 필요합니다. [Selenium Manager 문서](https://www.selenium.dev/documentation/selenium_manager/)

공식 안내

• What is ChromeDriver? · 확인 2026-10-09
• Chrome for Testing availability · 확인 2026-10-09
• Get started with ChromeDriver · 확인 2026-10-09
• Capabilities and ChromeOptions · 확인 2026-10-09
• Logging · 확인 2026-10-09
• Chrome doesn't start or crashes immediately · 확인 2026-10-09
• Clicking issues · 확인 2026-10-09
• Security considerations · 확인 2026-10-09
• Chromium source LICENSE · 확인 2026-10-09
• Selenium Manager · 확인 2026-10-09