Rodney v0.4.0: 브라우저 자동화 CLI의 테스트 기능 강화 및 Windows 지원

섹션별 상세

rodney assert 명령은 브라우저 컨텍스트 내에서 임의의 JavaScript 표현식을 실행하고 그 결과를 검증하는 기능을 제공한다. 이 명령은 표현식의 결과가 거짓(false)이거나 기대값과 다를 경우 종료 코드 1을 반환하도록 설계되어 셸 스크립트 기반의 자동화 테스트에서 조건부 로직을 처리하기에 용이하다. 이를 통해 웹 페이지의 제목, 특정 요소의 개수, 또는 복잡한 DOM 상태를 선언적으로 확인할 수 있다.

bash

#!/bin/bash
set -euo pipefail
FAIL=0
check() {
  if ! "$@"; then
    echo "FAIL: $*"
    FAIL=1
  fi
}
rodney start
rodney open "https://example.com"
rodney waitstable
# Assert elements exist
check rodney exists "h1"
# Assert key elements are visible
check rodney visible "h1"
check rodney visible "#main-content"
# Assert JS expressions
check rodney assert 'document.title' 'Example Domain'
check rodney assert 'document.querySelectorAll("p").length' '2'
# Assert accessibility requirements
check rodney ax-find --role navigation
rodney stop
if [ "$FAIL" -ne 0 ]; then
  echo "Some checks failed"
  exit 1
fi
echo "All checks passed"

rodney 명령어를 사용하여 웹 페이지의 요소 존재 여부, 가시성, JavaScript 표현식 및 접근성을 검증하는 셸 스크립트 예시

--local 및 --global 플래그를 통해 디렉토리 단위의 세션 관리가 가능해졌다. --local 플래그를 사용하면 현재 작업 디렉토리에 종속된 독립적인 브라우저 프로필이 생성되어, 여러 프로젝트를 동시에 작업할 때 쿠키나 로컬 스토리지 데이터가 섞이지 않도록 보장한다. 이는 특히 인증이 필요한 여러 웹 서비스를 동시에 자동화할 때 유용한 기능이다.

rodney connect PORT 명령을 사용하여 이미 실행 중인 Chrome 브라우저 인스턴스에 원격으로 연결하여 제어할 수 있는 기능이 추가되었다. 기존에는 매번 새로운 브라우저 세션을 시작해야 했으나, 이제는 개발자가 수동으로 열어둔 브라우저나 디버그 모드로 실행 중인 인스턴스에 접속하여 명령을 내릴 수 있다. 이는 자동화 스크립트의 디버깅 속도를 획기적으로 높여주는 도구로 활용된다.

Windows 운영체제에 대한 공식적인 지원이 확보되었으며 이를 위해 내부적인 프로세스 관리 로직이 수정되었다. Unix 계열에서 사용하던 Setsid 호출을 Windows 환경에서 회피할 수 있도록 빌드 태그 기반의 헬퍼 함수를 도입했으며, GitHub Actions CI 파이프라인에 Windows와 macOS 환경을 추가하여 교차 플랫폼 안정성을 검증한다. 또한 RODNEY_HOME 환경 변수를 통해 상태 저장 디렉토리를 자유롭게 변경할 수 있는 유연성도 갖추었다.

용어 해설

브라우저 자동화(Browser Automation): — 브라우저 자동화는 소프트웨어를 통해 웹 브라우저의 동작을 제어하고 웹 페이지와 상호작용하는 기술이다. 사람이 직접 클릭하거나 입력하는 과정을 코드로 구현하여 데이터 수집이나 반복적인 테스트를 효율적으로 수행할 수 있게 하며, 현대적인 웹 개발 및 품질 보증 프로세스에서 핵심적인 역할을 담당한다.
종료 코드(Exit Code): — 종료 코드는 프로세스가 실행을 마치고 운영체제에 반환하는 정수 값이다. 일반적으로 0은 성공을 의미하며, 1 이상의 값은 오류의 종류나 특정 상태를 나타낸다. 자동화 스크립트에서 이전 명령의 성공 여부를 판단하여 다음 단계의 실행 여부를 결정하는 중요한 지표로 활용된다.
헤드리스 브라우저(Headless Browser): — 헤드리스 브라우저는 사용자 인터페이스 없이 백그라운드에서 실행되는 웹 브라우저다. 화면 출력에 필요한 리소스를 소모하지 않아 속도가 빠르고 서버 환경에서 실행하기 적합하며, 웹 크롤링, 자동화 테스트, 스크린샷 생성 등 시각적 확인이 필요 없는 다양한 자동화 작업에 필수적으로 사용된다.
엔드 투 엔드 테스트(E2E Testing): — 엔드 투 엔드 테스트는 실제 사용자 시나리오를 바탕으로 애플리케이션의 전체 흐름이 처음부터 끝까지 올바르게 작동하는지 검증하는 방식이다. UI 요소부터 백엔드 데이터베이스까지 모든 구성 요소가 통합되어 의도한 대로 동작하는지 확인하며, 시스템의 신뢰성을 보장하는 최종적인 테스트 단계다.

기술

Rodney
JavaScript
Bash
Chrome
GitHub Actions

활용 사례

웹 애플리케이션 E2E 테스트 자동화
프로젝트별 독립 브라우저 세션 관리
기존 브라우저 인스턴스 원격 디버깅

언급된 리소스

문서Rodney v0.4.0 Release Notes