【QA 자동화】Selenium으로 회원가입 E2E 테스트 구현 | 로그·스크린샷 포함 완전 해설 (Python)

📌 이런 분께 추천합니다

• Selenium을 활용한 웹 브라우저 자동화에 관심 있는 개발자 및 QA 엔지니어
• 회원가입·폼 입력 자동화를 배우고 싶은 분
• 로그인·로그아웃 E2E 테스트를 구현하고 싶은 분
• 스크린샷 캡처 및 로그 관리를 자동화하고 싶은 분

✅ 이 글을 읽으면 얻을 수 있는 것

• Selenium으로 여러 페이지에 걸친 폼 조작을 자동화하는 구현 패턴을 익힐 수 있습니다
• XPath를 활용한 유연한 요소 탐색 방법을 배울 수 있습니다
• 로그 출력·스크린샷 관리의 실무적인 구현 방법을 습득할 수 있습니다
• 회원가입 → 로그아웃 → 로그인의 전체 E2E 흐름을 직접 구성할 수 있게 됩니다

👨‍💻 이 글의 신뢰성에 대해

이 글은 실무에서 자동화 테스트를 담당하는 QA 엔지니어가 실제로 동작을 확인한 코드를 바탕으로 작성했습니다.
소스코드는 모두 GitHub에 공개되어 있습니다
(automated-testing-portfolio).
실무에서 쌓은 노하우를 아낌없이 담았습니다.

🎯 이 테스트의 목적: 사용자가 정상적으로 회원가입을 완료할 수 있는지를 E2E로 검증합니다. 가입 완료뿐만 아니라 이후의 로그인·로그아웃까지 일관되게 보장합니다.

▲ Selenium이 자동 입력한 회원가입 폼. 테스트 데이터가 전체 항목에 정확하게 입력되어 있음

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
from selenium.webdriver.support.ui import Select
from datetime import datetime
import os
import time

class YodobashiAutoSignup:
    def __init__(self, headless=False):
        self.top_url = "https://www.yodobashi.com/"
        self.register_url = "https://order.yodobashi.com/yc/member/register/index.html"
        options = webdriver.ChromeOptions()
        options.add_argument('--disable-blink-features=AutomationControlled')
        if not headless:
            options.add_argument('--start-maximized')
        else:
            options.add_argument('--headless')
        options.add_argument('--disable-popup-blocking')
        self.driver = webdriver.Chrome(options=options)
        self.wait = WebDriverWait(self.driver, 15)
        self.log_folder = os.path.join(
            os.path.expanduser("~"), "Desktop", "yodobashi_signup_logs"
        )
        self.setup_log_folder()
        self.log_file = os.path.join(
            self.log_folder,
            f"signup_log_{datetime.now().strftime('%Y%m%d_%H%M%S')}.txt"
        )

    def setup_log_folder(self):
        if not os.path.exists(self.log_folder):
            os.makedirs(self.log_folder)

    def log(self, message):
        timestamp = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
        log_message = f"[{timestamp}] {message}"
        print(log_message)
        with open(self.log_file, 'a', encoding='utf-8') as f:
            f.write(log_message + '\n')

    def take_screenshot(self, name):
        screenshot_name = name.replace('(', '_').replace(')', '').replace(' ', '_')
        screenshot_path = os.path.join(
            self.log_folder,
            f"screenshot_{screenshot_name}_{datetime.now().strftime('%H%M%S')}.png"
        )
        self.driver.save_screenshot(screenshot_path)
        self.log(f"  📷 Screenshot: {os.path.basename(screenshot_path)}")
        return screenshot_path

    # ---- 이하 fill_basic_info / fill_address / fill_contact_info /
    #      fill_password / accept_terms / click_next_button /
    #      click_confirm_button / navigate_to_register_page /
    #      signup_complete / login / logout / reset_password /
    #      close 등을 구현 ----

# 실행 예시
if __name__ == "__main__":
    user_data = {
        "last_name": "Yamada",
        "first_name": "Taro",
        "last_kana": "ヤマダ",
        "first_kana": "タロウ",
        "postal_code": "1500001",
        "address_detail": "1-1-1",
        "building": "Sample Building 101",
        "phone": "09012345678",
        "birth_year": "1990",
        "birth_month": "1",
        "birth_day": "1",
        "email": "test822211@example.com"
    }

    bot = YodobashiAutoSignup(headless=False)
    try:
        result = bot.signup_complete(user_data, password="hjerty12")
        print(f"Result: {result['message']}")
    finally:
        bot.close()

🔍 포인트: --disable-blink-features=AutomationControlled 옵션으로 Selenium의 자동 조작을 감지하기 어렵게 만듭니다.

⚠ 주의: 로그 파일과 스크린샷은 데스크톱의 yodobashi_signup_logs 폴더에 자동 저장됩니다. 실행할 때마다 타임스탬프가 포함된 새 파일이 생성되므로 실행 이력이 덮어쓰여지지 않습니다.

💡 실무 Tip: QA 현장에서는 “테스트 에비던스(증적)”의 제출이 요구되는 경우가 많습니다. 스크린샷을 자동 수집해 두면 테스트 보고서 작성 공수를 대폭 절감할 수 있습니다.

⚠ 포인트: 'kana' not in name_attr.lower() 조건으로 가나 계열 필드를 명시적으로 제외합니다.

postal = user_data['postal_code']  # 예: '1500001'
postal1 = postal[:3]   # '150'
postal2 = postal[3:]   # '0001'

# name 속성에 'zip' 또는 'postal'을 포함하는 input을 추출
postal_inputs = []
for inp in self.driver.find_elements(By.XPATH, "//input[@type='text']"):
    name_attr = inp.get_attribute('name') or ''
    if 'zip' in name_attr.lower() or 'postal' in name_attr.lower():
        postal_inputs.append(inp)

🔍 설계 포인트: 완전 일치보다 부분 일치가 변경에 강하다는 실무적인 사고방식입니다.

💡 Tip: 드롭다운 조작에는 반드시 Select(element)로 래핑해야 합니다. 직접 click()해도 옵션이 선택되지 않으므로 주의하세요.

💡 Tip: arguments[0].click()과 arguments[0].checked = true는 별개이므로 둘 다 준비해 두면 거의 모든 케이스에 대응 가능합니다.

⚠ 설계 포인트: 복수의 셀렉터를 우선순위를 붙여 시도하는 폴백 설계는 실무 Selenium 테스트에서 꼭 도입하고 싶은 수법입니다.

🔍 포인트: 이전 단계의 상태에 의존하지 않는 견고한 테스트 플로우를 실현하고 있습니다.

[2025-07-10 14:32:01] ======================================================================
[2025-07-10 14:32:01] Yodobashi Camera Member Registration Automation (Full Flow)
[2025-07-10 14:32:02] [Step 1] Navigating to member registration page...
[2025-07-10 14:32:05]   ✓ Registration link clicked
[2025-07-10 14:32:08] [Step 2] Filling in basic information...
[2025-07-10 14:32:09]   ✓ Last name: Yamada
[2025-07-10 14:32:09]   ✓ First name: Taro
[2025-07-10 14:32:11] [Step 3] Filling in address information...
[2025-07-10 14:32:12]   ✓ Postal code: 150-0001
[2025-07-10 14:32:14]   ✓ Address search executed
[2025-07-10 14:32:18]   📷 Screenshot: screenshot_02_form_filled_143218.png
[2025-07-10 14:32:32] ✓ Member registration complete!
[2025-07-10 14:32:45]   ✓ Login successful!
[2025-07-10 14:32:50] Final result: Registration, logout, login, and logout all completed!

⚠️ 이런 에러가 나오는 경우는？

======================================================================
결과: 비밀번호 입력에 실패했습니다
Email: test****@example.com
Password: ******
로그 파일: C:\Users\HP\Desktop\yodobashi_signup_logs\signup_log_****.txt
======================================================================

이 에러가 나오는 가장 흔한 원인은 이미 등록된 이메일 주소를 사용하고 있는 경우입니다.

• email 값을 다른 주소(예: test_99999@example.com)로 변경하여 재실행하세요
• 테스트용으로 여러 개의 이메일 주소 패턴을 미리 준비해 두면 편리합니다
• 동일한 주소로 재가입을 시도하면 “중복 가입 에러”가 발생하여 비밀번호 입력 단계까지 진행할 수 없습니다

▲ 실제 터미널 출력. 단계1（페이지 이동）→ 단계2（기본 정보 입력）→ 단계3（주소 입력）이 순서대로 실행됨

🚀 이 코드가 빛나는 장면

▲ 자동 저장된 로그 폴더의 내용. 로그 파일 + 스크린샷 4장이 타임스탬프와 함께 정리되어 있음