파이썬 Selenium 고급 활용 다국어 UI 테스트 자동화 셀렉터 전략

🌐 다국어 UI 테스트의 필요성과 도전 과제

인터넷 서비스가 전 세계로 확장되면서 다국어 지원은 선택이 아닌 필수가 되었습니다.
사용자가 언어 설정을 바꿨을 때 UI가 정상적으로 동작하는지 확인하는 것은 서비스 신뢰성과 직결됩니다.
하지만 다국어 테스트는 단순한 번역 확인을 넘어서는 복잡한 문제를 안고 있습니다.
언어별로 텍스트 길이가 달라 UI 배치가 깨지기도 하고, RTL(Right-To-Left) 언어의 경우 전체적인 인터페이스 구조가 반전되기 때문에 추가적인 검증이 필요합니다.

또한 셀렉터 전략은 다국어 테스트에서 가장 큰 난관 중 하나입니다.
예를 들어 영어 UI에서는 “Login” 버튼이지만 한국어 UI에서는 “로그인”, 프랑스어 UI에서는 “Connexion”으로 표시될 수 있습니다.
이 경우 단순히 텍스트를 기반으로 한 셀렉터는 언어 변경 시 무용지물이 되어버리죠.
따라서 언어에 의존하지 않는 속성 기반 셀렉터, 혹은 데이터-테스트-id를 활용하는 전략이 필수적입니다.

🚧 다국어 테스트에서 흔히 발생하는 문제

• 🔡텍스트 길이 차이로 인한 버튼/라벨 깨짐
• ↔️RTL 언어 지원 부족으로 발생하는 레이아웃 오류
• 🧩텍스트 기반 셀렉터 사용 시 다국어 환경에서 테스트 실패
• 🌍언어별 날짜·숫자 포맷 불일치

이처럼 다국어 UI 테스트는 단순한 자동화 스크립트로는 해결하기 어려운 난관을 동반합니다.
따라서 Selenium을 활용한 고급 전략이 반드시 필요하며, 앞으로의 섹션에서는 언어 토글, 문자 폭 테스트, RTL 대응, 그리고 안정적인 셀렉터 설계까지 단계별로 살펴보겠습니다.

🛠️ Selenium에서 언어 토글 자동화하기

대부분의 글로벌 웹서비스는 헤더 또는 푸터에 언어 변경 토글을 제공합니다.
Selenium으로 다국어 UI를 테스트하려면, 이 언어 토글 버튼을 자동으로 조작하고, 변경된 UI 요소가 정상적으로 표시되는지 검증해야 합니다.
이를 위해서는 단순 클릭을 넘어서 DOM 변화를 감지하고, 언어가 실제로 적용되었는지 확인하는 로직이 필요합니다.

언어 토글 자동화를 구현할 때 가장 중요한 점은 언어 전환 후 UI의 일관성입니다.
예를 들어 한국어 → 영어 전환 후 버튼의 aria-label이나 data-testid 값이 동일하게 유지되는지를 확인해야 합니다.
텍스트 기반의 검증보다는 언어 불변 속성을 활용하는 것이 안정성을 높이는 핵심입니다.

🔄 언어 토글 버튼 테스트 예제

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

driver = webdriver.Chrome()
driver.get("https://example.com")

# 언어 토글 버튼 클릭
lang_toggle = driver.find_element(By.ID, "lang-switch")
lang_toggle.click()

# 전환 후 특정 요소의 속성 확인
element = WebDriverWait(driver, 10).until(
    EC.presence_of_element_located((By.CSS_SELECTOR, "[data-testid='login-button']"))
)
print("버튼 라벨:", element.text)

위 예제에서는 data-testid 속성을 이용해 언어와 상관없이 동일한 요소를 찾도록 했습니다.
이는 언어 전환 시에도 깨지지 않는 안정적인 테스트 방법이며, 실제 프로젝트에서도 널리 사용되는 전략입니다.

⚙️ 문자 폭과 UI 깨짐 테스트 전략

다국어 UI 테스트에서 가장 빈번하게 발생하는 문제 중 하나는 바로 텍스트 길이 차이입니다.
예를 들어, 영어의 “Login”은 단 5글자지만, 독일어 “Anmelden”은 8글자, 프랑스어 “Se connecter”는 공백 포함 12자에 달합니다.
이처럼 언어에 따라 글자 수가 달라지면 버튼 크기, 라벨 정렬, 입력창 placeholder 등이 깨질 수 있습니다.

Selenium을 활용하면 실제 화면에서 문자 폭이 늘어난 상태를 시뮬레이션하고, UI가 정상적으로 표시되는지 확인할 수 있습니다.
또한 예상보다 긴 텍스트를 강제로 삽입해 보면서 레이아웃이 무너지지 않는지를 검증하는 방식도 활용됩니다.

🧪 문자 폭 테스트 구현 예제

# 예시: Selenium으로 버튼 텍스트 길이 확인
button = driver.find_element(By.CSS_SELECTOR, "[data-testid='login-button']")
text_length = len(button.text)

if text_length > 15:
    print("⚠️ UI 깨짐 가능성 있음:", button.text)
else:
    print("✅ 정상:", button.text)

이처럼 단순히 텍스트를 확인하는 것뿐 아니라, DOM 요소 크기(width, height)를 직접 가져와 화면이 깨지지 않았는지도 확인하는 것이 중요합니다.

📊 문자 폭 테스트 체크리스트

• 🔎텍스트 길이가 다른 주요 언어(영어, 독일어, 프랑스어, 한국어)에서 UI 검증
• 📐DOM 요소 크기(width, height) 측정 후 정상 여부 판단
• 📝버튼·라벨·입력창 placeholder 등 핵심 요소 중심으로 테스트
• 🚀자동화 파이프라인에 포함시켜 정기적으로 UI 깨짐 감지

↔️ RTL 언어(아랍어·히브리어) 레이아웃 검증

글로벌 서비스에서 RTL(Right-To-Left) 언어를 지원하는 것은 더 이상 선택이 아닌 필수 요소가 되었습니다.
아랍어, 히브리어, 페르시아어 등은 화면의 기본 흐름이 오른쪽에서 왼쪽으로 진행되며, 이때 레이아웃 전체가 반전되어야 올바르게 표시됩니다.
따라서 Selenium 테스트에서는 단순히 텍스트 번역만 확인하는 것이 아니라, UI 요소가 RTL 모드에서도 올바른 위치에 배치되는지를 반드시 검증해야 합니다.

실무에서는 CSS의 dir="rtl" 속성을 감지하거나, body 태그의 direction 속성을 확인해 레이아웃이 제대로 반영되었는지를 검사합니다.
또한 RTL 모드에서 버튼 아이콘, 드롭다운, 네비게이션 바 위치까지 정상적으로 반전되는지 확인하는 것이 중요합니다.

🧭 RTL 테스트 구현 예제

# RTL 모드 활성화 후 direction 속성 검증
body = driver.find_element(By.TAG_NAME, "body")
direction = body.get_attribute("dir")

if direction == "rtl":
    print("✅ RTL 모드 정상 적용")
else:
    print("⚠️ RTL 모드 적용 실패")

또한, RTL 환경에서는 아이콘 방향까지 확인해야 합니다.
예를 들어, “뒤로가기 버튼”은 LTR 환경에서는 왼쪽 화살표지만, RTL 환경에서는 오른쪽 화살표로 표시되어야 합니다.

📌 RTL 검증 체크리스트

• 🖥️body 태그의 dir=”rtl” 속성 적용 여부
• 📑네비게이션 바, 메뉴 위치 반전 확인
• ⬅️아이콘 방향 반전 (예: 뒤로가기 화살표)
• 📝폼 입력 필드 커서 위치 (RTL에서는 오른쪽 정렬)

🔍 셀렉터 안정성 확보를 위한 베스트 프랙티스

다국어(i18n) UI 테스트에서 가장 중요한 요소는 안정적인 셀렉터 설계입니다.
언어가 바뀔 때마다 버튼 텍스트, 라벨, 메뉴명이 달라지기 때문에 단순히 텍스트를 기준으로 요소를 찾는 방식은 테스트 실패로 이어지기 쉽습니다.
따라서 프로젝트 초기 단계에서부터 셀렉터 전략을 체계적으로 수립해야 장기적으로 유지보수가 가능한 자동화 환경을 구축할 수 있습니다.

🛡️ 안정적인 셀렉터 설계 원칙

• 🏷️data-testid 또는 role 속성 기반의 셀렉터 활용
• 🔒언어에 따라 변하지 않는 고정 속성 활용
• 🧭텍스트 기반 선택자는 최후의 수단으로만 사용
• 🔗XPath 사용 시 구조적 안정성을 고려한 작성

💻 안정적인 셀렉터 코드 예제

# data-testid 속성을 활용한 안정적인 선택자
login_button = driver.find_element(By.CSS_SELECTOR, "[data-testid='login-button']")

# XPath를 활용할 경우 구조 기반 접근
menu_item = driver.find_element(By.XPATH, "//nav[@role='navigation']//li[1]")

이처럼 다국어 환경에서는 UI 텍스트가 아닌 속성 기반 셀렉터를 사용하는 것이 필수입니다.
이를 통해 언어가 바뀌더라도 동일한 UI 요소를 안정적으로 식별할 수 있습니다.

❓ 자주 묻는 질문 (FAQ)