효율적인 UI 자동화 테스트를 위한 POM(Page Object Model) 디자인 패턴

웹 UI 자동화 테스트를 처음 접할 때 가장 흔히 작성하는 방식은 코드가 순차적으로 나열된 선형 스크립트(Linear Script)입니다. 하지만 프로젝트의 규모가 커질수록 이러한 방식은 유지보수에 심각한 병목 현상을 일으킵니다. 이를 해결하기 위한 표준 설계 방식인 POM(Page Object Model) 디자인 패턴에 대해 알아봅니다.

선형 스크립트의 한계

브라우저를 열고 요소를 찾아 동작을 수행한 뒤 결과를 검증하는 단순한 흐름의 코드는 직관적이지만 다음과 같은 치명적인 단점이 있습니다.

  • 중복 코드 발생: 여러 테스트 케이스에서 동일한 로그인 버튼이나 메뉴를 호출할 때마다 코드가 반복됩니다.
  • 낮은 가독성: 요소의 로케이터(Locator)와 테스트 로직이 뒤섞여 코드를 이해하기 어렵습니다.
  • 유지보수의 어려움: UI 레이아웃이 변경되어 버튼의 ID나 XPath가 바뀌면, 해당 요소를 사용하는 모든 테스트 코드를 일일이 수정해야 합니다.

예를 들어, 다음은 일반적인 방식의 로그인 테스트 코드입니다.

from selenium import webdriver
from selenium.webdriver.common.by import By
import time

def login_test():
    browser = webdriver.Chrome()
    browser.get("https://example-portal.com/login")
    
    # 요소 위치와 동작이 결합된 형태
    browser.find_element(By.NAME, "username").send_keys("test_user")
    browser.find_element(By.ID, "pw_field").send_keys("password123")
    browser.find_element(By.CSS_SELECTOR, ".btn-submit").click()
    
    time.sleep(3)
    welcome_msg = browser.find_element(By.TAG_NAME, "h1").text
    assert "환영합니다" in welcome_msg
    
    browser.quit()

POM(Page Object Model)이란?

POM은 웹 애플리케이션의 각 페이지를 하나의 객체(Object)로 모델링하는 디자인 패턴입니다. 페이지 내의 요소(Element)와 그 요소를 조작하는 동작(Action)을 별도의 클래스로 캡슐화하여, 테스트 로직과 UI 구조를 분리하는 것이 핵심입니다.

이 패턴을 적용하면 테스트 스크립트는 실제 비즈니스 로직(사용자 시나리오)에만 집중할 수 있고, UI 변경 시에는 해당 페이지 클래스만 수정하면 되므로 재사용성과 유지보수성이 극대화됩니다.

Page Object 디자인의 6가지 핵심 원칙

Selenium 공식 문서에서는 효과적인 POM 구현을 위해 다음과 같은 원칙을 제시합니다.

  1. 공용 메서드로 서비스 제공: 페이지 클래스의 public 메서드는 해당 페이지가 제공하는 기능을 대표해야 합니다. (예: input_credentials(), submit_form())
  2. 내부 상세 구현 은닉: 페이지 내부의 로케이터나 세부 동작을 외부에 노출하지 않고 메서드 뒤로 숨깁니다.
  3. 페이지 객체 내 단언(Assertion) 지양: 페이지 클래스는 UI 조작에 집중해야 하며, 성공 여부를 검증하는 단언문은 테스트 케이스 레이어에서 작성합니다.
  4. 연속된 페이지 전환 처리: 특정 동작(예: 로그인 버튼 클릭)이 다른 페이지로 이동시킨다면, 해당 메서드는 새로운 페이지의 객체를 반환해야 합니다.
  5. 필요한 요소만 모델링: 페이지의 모든 요소를 정의할 필요는 없으며, 테스트에 필요한 부분만 선별적으로 구현합니다.
  6. 결과에 따른 개별 메서드 구성: 동일한 동작이라도 성공과 실패의 결과가 확연히 다르다면 각각 별도의 메서드로 정의하는 것이 좋습니다.

표준적인 POM 프레임워크 구조

실무에서는 다음과 같이 계층을 나누어 프로젝트를 구성합니다.

  • Base Layer (기초): 모든 페이지 객체의 부모가 되는 클래스입니다. find_element, click, wait 등 Selenium API를 프로젝트 성격에 맞게 래핑(Wrapping)하여 예외 처리나 로그 기능을 추가합니다.
  • Page Objects (페이지 객체): 페이지별로 클래스를 생성합니다. 요소의 위치 정보와 비즈니스 액션 메서드를 포함합니다.
  • Test Cases (테스트 케이스): Pytest나 Unittest 같은 프레임워크를 사용하여 실제 테스트 시나리오를 작성합니다.
  • Data Drive (데이터 관리): 테스트에 사용되는 계정 정보, URL 등을 YAML이나 JSON 파일로 분리하여 관리합니다.
  • Utilities (공통 모듈): 스크린샷 저장, 리포트 생성, DB 연결 등 공통 함수를 모아둡니다.

아래는 POM 방식으로 재구성한 페이지 클래스의 예시입니다.

class LoginPage(BasePage):
    # 로케이터 관리
    _USER_FIELD = (By.NAME, "username")
    _PW_FIELD = (By.ID, "pw_field")
    _LOGIN_BTN = (By.CSS_SELECTOR, ".btn-submit")

    def execute_login(self, uid, pwd):
        self.enter_text(self._USER_FIELD, uid)
        self.enter_text(self._PW_FIELD, pwd)
        self.click_element(self._LOGIN_BTN)
        # 로그인 후 대시보드 페이지 객체 반환
        return DashboardPage(self.driver)

이와 같이 POM을 적용하면 UI 코드가 바뀌어도 테스트 케이스 자체를 수정할 필요가 없어지며, 협업 과정에서 코드의 의도를 파악하기가 훨씬 수월해집니다.

태그: selenium python Test Automation Page Object Model Design Patterns

11월 7일 08:28에 게시됨