【QA自動化】Seleniumで会員登録E2Eテストを実装｜ログ・スクショ付き完全解説

📌 この記事はこんな方におすすめ

Seleniumを使ったWebブラウザ自動化に興味がある方
会員登録・フォーム入力の自動化を学びたいQAエンジニア・開発者
ログイン・ログアウトのE2Eテストを実装したい方
スクリーンショット取得やログ管理を自動化したい方

✅ この記事を読むと得られること

Seleniumで複数ページにわたるフォーム操作を自動化する実装パターンがわかる
XPathによる柔軟な要素特定の書き方が身につく
ログ出力・スクリーンショット管理の実務的な実装方法を習得できる
登録→ログアウト→ログインの一連のE2Eフローを自分で組めるようになる

👨‍💻 この記事の信頼性について

本記事はQAエンジニアとして実務で自動化テストに携わる筆者が、実際に動作確認済みのコードをもとに解説しています。
ソースコードはすべて GitHub にて公開中（automated-testing-portfolio）。
実務で培ったノウハウを惜しみなく詰め込んでいます。

「会員登録フォームのテストを毎回手動でやるのはもう限界…」そんな悩みを抱えたことはありませんか？
本記事では Python × Selenium を使って、ヨドバシカメラの会員登録フォームを自動で入力・送信・ログイン確認まで行うスクリプトを徹底解説します。
XPathの複数パターンによる堅牢な要素特定、ログとスクリーンショットによるデバッグのしやすさなど、実務で即使えるQA自動化の設計思想を余すところなく紹介します。

🎯 このテストの目的：ユーザーが正常に会員登録できるかをE2Eで検証します。登録完了だけでなく、その後のログイン・ログアウトまで一気通貫で保証します。

テスト観点
このスクリプトでできること
自動化フロー全体像
ソースコード全文
主要メソッド解説
実行ログのサンプル
さらに発展させるための改善アイデア
活用シーン・拡張例
実務への応用：POM設計 × CI/CD連携
ハマりポイント
まとめ

テスト観点

本スクリプトは以下のテスト観点をカバーしています。QAエンジニアとして「何を保証するテストか」を明確にしておくことが実務では重要です。

観点	内容	本スクリプトでの対応
✅ 正常系	登録成功・ログイン成功	登録→ログアウト→ログインを一気通貫で検証
⚠️ 未入力エラー	必須項目が未入力の場合のエラー表示確認	各ステップ失敗時にログ出力＋スクリーンショット保存
⚠️ 不正メール形式	「@なし」「ドメインなし」など不正な形式での入力	テストデータを差し替えて異常系パターンを検証可能
⚠️ PW条件違反	文字数不足・使用不可文字など条件を満たさないPW	`fill_password()` のパラメータを変えて確認可能
🔁 重複登録	同一メールアドレスで2回目の登録を試みた際の挙動	同じ `email` を使って再実行することで確認可能

このスクリプトでできること

1つのクラスに登録〜ログアウト〜ログインまで完結する、フル自動化フローを実装しています。

📝

フォーム自動入力

氏名・フリガナ・住所・電話番号・生年月日・メールアドレスを自動で入力

📮

郵便番号→住所検索

郵便番号入力後に「住所を検索する」ボタンをクリックし、住所候補から選択

✅

規約同意チェックボックス

チェックボックスへのクリック・状態確認・JS経由のフォールバック対応

🔐

パスワード入力（確認画面）

確認画面でパスワードと確認用パスワードを自動入力

📸

スクリーンショット自動保存

各ステップで自動的にPNG保存。デバッグ時に視覚的に確認できる

📋

ログファイル出力

タイムスタンプ付きのログをテキストファイルに保存。実行履歴を追跡可能

自動化フロー全体像

signup_complete() メソッドが全ステップを統括します。各ステップが独立したメソッドに分離されているため、デバッグや再利用が容易です。

Step	処理内容	呼び出しメソッド	スクリーンショット
1	トップページ→会員登録ページへ遷移	`navigate_to_register_page()`	01_registration_page.png
2	氏名・フリガナ入力	`fill_basic_info()`	—
3	郵便番号・住所入力	`fill_address()`	—
4	電話番号・生年月日・メール入力	`fill_contact_info()`	—
5	利用規約への同意チェック	`accept_terms()`	02_form_filled.png
6	「次へ進む」ボタンクリック	`click_next_button()`	03_confirmation_page.png
7	確認画面でパスワード入力	`fill_password()`	04_password_filled.png
8	「登録する」ボタンクリック	`click_confirm_button()`	05_registration_complete.png
9	ログアウト	`logout()`	06_after_logout.png
10	登録アカウントでログイン確認	`login()`	07_after_login.png
11	2回目のログアウト	`logout()`	08_after_second_logout.png

実際にスクリプトを実行すると、氏名・フリガナ・住所・電話番号・生年月日・メールアドレスがすべて自動で入力されます。テストデータは辞書形式で管理しているため、別のデータに差し替えるのも簡単です。

Seleniumで会員登録フォームに自動入力した画面。氏名・住所・電話番号・生年月日がすべて自動入力されている

▲ 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": "山田",
        "first_name": "太郎",
        "last_kana": "ヤマダ",
        "first_kana": "タロウ",
        "postal_code": "1500001",
        "address_detail": "1-1-1",
        "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()

主要メソッド解説

クラスは全部で10以上のメソッドで構成されています。それぞれが独立した責務を持ち、単体でのデバッグ・再利用・拡張がしやすい設計になっています。以下で特に重要なメソッドを詳しく解説します。

① init() ─ クラスの初期化・ChromeDriverの設定

クラスのインスタンス生成時に呼ばれる初期化メソッドです。ChromeDriverのオプション設定、ログフォルダの作成、WebDriverWaitの準備などをここで行います。引数 headless=False を True に変えるだけでブラウザを非表示にして実行できるため、CI/CD環境での実行にも対応しています。

🔍 ポイント：--disable-blink-features=AutomationControlled オプションを追加することで、Seleniumによる自動操作をサイト側に検知されにくくしています。これはBot対策が施されたサイトでのテストに有効なテクニックです。

⚠ 注意：ログファイルとスクリーンショットはデスクトップの yodobashi_signup_logs フォルダに自動保存されます。実行のたびにタイムスタンプ付きの新規ファイルが作成されるため、実行履歴が上書きされることはありません。

② log() / take_screenshot() ─ ログ管理とエビデンス収集

log() はタイムスタンプ付きのメッセージをコンソールとテキストファイルの両方に同時出力します。take_screenshot() は任意のタイミングで画面キャプチャをPNG保存する仕組みです。この2つのメソッドが全ステップに挿入されているため、テスト失敗時に「どのステップで・何が起きたか」を画像と文字ログで追跡できます。

💡 実務Tip：QAの現場では「テストエビデンス（証跡）」の提出が求められることが多いです。スクリーンショットを自動収集しておくことで、テスト報告書の作成工数を大幅に削減できます。allure-pytestと組み合わせると、スクショ付きのHTMLレポートを自動生成することも可能です。

③ fill_basic_info() ─ 氏名・フリガナの自動入力

全 input[type="text"] を一括取得し、placeholder 属性と name 属性の文字列でフィールドを特定します。単純に「最初のinputに入力する」という実装ではなく、属性値を見て判断するアプローチを取ることで、フォームの順番が変わっても壊れにくくなっています。

⚠ ポイント：kana 系のフィールドを誤って漢字フィールドに混入させないよう、'kana' not in name_attr.lower() の条件で明示的に除外しています。

④ fill_address() ─ 郵便番号検索＋住所入力

住所入力は単純な文字入力ではなく、郵便番号検索→候補選択→番地入力という複数ステップが絡む処理です。7桁の郵便番号を前3桁・後4桁に分割して2つのinputに入力後、「住所を検索する」ボタンをXPathで検索してクリックします。

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)

🔍 設計ポイント：郵便番号フィールドをid/nameではなく「zip・postalという文字列を含む」という条件で探しているのは、サイトリニューアルによるid変更に対応するためです。完全一致より部分一致の方が変更に強いという実務的な考え方です。

⑤ fill_contact_info() ─ 電話番号・生年月日・メールアドレスの入力

電話番号は11桁と10桁の両パターンに対応し、3分割して入力します。生年月日の「月」「日」は <select> タグのプルダウンになっているため、Select クラスを使って select_by_value() で選択します。

💡 Tip：プルダウン（selectタグ）の操作には必ず from selenium.webdriver.support.ui import Select をインポートして Select(element) でラップする必要があります。直接 click() してもオプションが選択できないので注意しましょう。

⑥ accept_terms() ─ 利用規約チェックボックス

id="js_i_checkPrivacyPolicyAgreement" で直接取得し、通常クリック → JSクリック → JSで直接プロパティ変更の3段構えで確実にチェックを入れます。クリック後に is_selected() で状態を再確認するのが堅牢さのポイントです。

💡 Tip：チェックボックスは visibility:hidden でラベルをクリックさせる実装も多いため、JSフォールバックはほぼ必須です。arguments[0].click()（クリックイベント発火）と arguments[0].checked = true（プロパティ直接変更）は別物なので両方持っておきましょう。

⑦ click_next_button() / click_confirm_button() ─ 画面遷移ボタンのクリック

「次へ進む」「この内容で登録する」「登録する」など、ボタンのテキストが複数パターン考えられるため、XPathセレクタを配列で持ち、上から順に試行する方式を採用しています。また、「戻る」「キャンセル」を含む要素は除外条件で確実に弾いています。

⚠ 設計のポイント：複数のセレクタを優先順位付きで試行するフォールバック設計は、実務のSeleniumテストでぜひ取り入れたい手法です。

⑧ login() / logout() ─ ログイン確認と後処理

登録完了後にそのままログアウト→ログインを実行することで、登録完了だけでなくログイン可能状態まで一気通貫で確認できます。ログイン成否の検証は body.text に「こんにちは」「さん」が含まれるかで判定しています。

メソッド	要素特定の工夫	成功判定ロジック
`login()`	複数セレクタを順番に試行。logout含むhrefは除外	body内に「こんにちは」「さん」が含まれるか
`logout()`	ユーザー名リンクのクリックでドロップダウンを開き「ログアウト」要素を検索	ログアウト要素が見つからない場合は「既にログアウト済み」としてTrueを返す

⑨ reset_password() ─ パスワードリセットフロー

「パスワードを忘れた方はこちら」リンクから始まるパスワードリセットフローを自動化します。メールアドレス・姓・名を入力して送信ボタンを押すまでの操作を自動で行います。

🔍 ポイント：リセットフロー開始前に logout() を呼び出してログアウト状態を確保しています。ログアウトが失敗しても処理を継続する設計により、前のステップの状態に依存しない堅牢なテストフローを実現しています。

実行ログのサンプル

実行するとコンソールとテキストファイルに以下のようなログが出力されます。各ステップの実行状況がリアルタイムで確認できます。

[2025-07-10 14:32:01] ======================================================================
[2025-07-10 14:32:01] Yodobashi Camera Member Registration Automation (Full Flow)
[2025-07-10 14:32:01] Password: hjerty12
[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]   📷 Screenshot: screenshot_01_registration_page_143208.png
[2025-07-10 14:32:08] [Step 2] Filling in basic information...
[2025-07-10 14:32:09]   ✓ Last name: 山田
[2025-07-10 14:32:09]   ✓ First name: 太郎
[2025-07-10 14:32:10]   ✓ Last name (Kana): ヤマダ
[2025-07-10 14:32:10]   ✓ First name (Kana): タロウ
[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:15]   ✓ Street address: 1-1-1
[2025-07-10 14:32:16] [Step 5] Agreeing to terms...
[2025-07-10 14:32:18]   ✓ Agreed to terms (normal click)
[2025-07-10 14:32:18]   📷 Screenshot: screenshot_02_form_filled_143218.png
[2025-07-10 14:32:19] [Step 6] Proceeding to confirmation screen...
[2025-07-10 14:32:22]   ✓ Click successful
[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〜3が順番に実行され、各入力項目が✓で確認されているのがわかります。

Seleniumで会員登録を自動化したターミナルログ。ステップ1から3まで各入力項目が順に実行されている

▲ 実際のターミナル出力。ステップ1（ページ遷移）→ステップ2（基本情報入力）→ステップ3（住所入力）と順番に実行される

さらに発展させるための改善アイデア

🔄 データ駆動テスト（DDT）

user_data をCSVやExcelから読み込む形式にすることで、複数ユーザーでの一括テストが可能になります。pandas.read_csv() と組み合わせると効果的です。

⚡ 並列実行で高速化

concurrent.futures.ThreadPoolExecutor や pytest-xdist を使った並列実行で、複数アカウントの登録確認を同時に行えます。

🛡️ リトライ機能の強化

ネットワーク遅延や動的コンテンツによる不安定さへの対策として、tenacity ライブラリを使った自動リトライ機構を追加するとより堅牢になります。

📊 HTMLレポート出力

pytest + allure-pytest を組み合わせることで、スクリーンショット付きの美麗なHTMLテストレポートを自動生成できます。

活用シーン・拡張例

🚀 このコードが活きる場面

🧪 リグレッションテスト

リリース前に会員登録フローが壊れていないかを自動で確認。CI/CD（GitHub Actions等）に組み込めば毎デプロイ後に自動実行できます。

📋 受け入れテスト自動化

ステークホルダーへの報告用にスクリーンショット付きのエビデンスを自動収集。テストエビデンス作成の工数を大幅削減できます。

🔧 E2Eテストの学習素材

Seleniumの要素特定・待機処理・スクリーンショット・ログ出力など、実務的なパターンが一通り詰まった学習教材として最適です。

🔄 パスワードリセットフロー確認

reset_password() メソッドで「パスワードを忘れた方はこちら」フローの動作確認も自動化。ログイン系の全シナリオをカバーできます。

実務への応用：POM設計 × CI/CD連携

📐 Page Object Model（POM）

実務ではPage Object Model（POM）を使ってテストコードを分離することで、保守性を高めます。ページごとにクラスを分け、操作ロジックとテストロジックを切り離すのがSeleniumの定番設計です。

pages/register_page.py  ← 操作ロジック
tests/test_register.py  ← テストケース

⚙️ CI/CD への組み込み

このテストはCI/CDに組み込むことで自動実行が可能です。GitHub Actionsと組み合わせれば、デプロイのたびに会員登録フローの品質を自動保証できます。

push → GitHub Actions起動
→ pytest実行 → レポート生成

ハマりポイント

実装中に実際につまずいた箇所をまとめました。同じところでハマる方の参考になれば嬉しいです。

① チェックボックスが通常クリックで反応しない

利用規約のチェックボックスに click() を実行しても、チェックが入らないケースが発生しました。原因はチェックボックス本体が visibility:hidden で隠されており、実際はラベル要素をクリックさせる実装になっていたためです。

# ❌ 通常クリックでは反応しないことがある
checkbox = driver.find_element(By.ID, "js_i_checkPrivacyPolicyAgreement")
checkbox.click()

# ✅ JSクリック → プロパティ直接変更の3段構えで解決
try:
    checkbox.click()
except:
    driver.execute_script("arguments[0].click();", checkbox)
    if not checkbox.is_selected():
        driver.execute_script("arguments[0].checked = true;", checkbox)

💡 ポイント： arguments[0].click()（クリックイベント発火）と arguments[0].checked = true（プロパティ直接変更）は別物です。両方持っておくとほぼ全てのケースに対応できます。

② プルダウン（selectタグ）が直接クリックで選択できない

生年月日の「月」「日」がプルダウンになっていたため、通常の click() では選択できませんでした。Select クラスを使わないと値を選択できないことを知らずにハマりました。

# ❌ 直接クリックしても選択できない
month_element.click()

# ✅ Selectクラスでラップして操作
from selenium.webdriver.support.ui import Select
select = Select(month_element)
select.select_by_value("1")  # 1月を選択

💡 ポイント： <select> タグの操作には必ず Select クラスを使います。インポートを忘れずに。

③ ボタンのXPathが1パターンだと壊れやすい

「次へ進む」ボタンをXPath1パターンで指定していたところ、サイトの微妙な変更でボタンが見つからなくなりました。ボタンのテキストは「次へ」「次へ進む」「進む」など複数パターン存在することが多いため、1つだけでは不十分でした。

# ❌ 1パターンだけだと壊れやすい
button = driver.find_element(By.XPATH, "//button[text()='次へ進む']")

# ✅ 複数パターンを順番に試すフォールバック設計
selectors = [
    "//button[contains(text(),'次へ')]",
    "//input[@type='submit']",
    "//a[contains(text(),'次へ')]",
]
for selector in selectors:
    elements = driver.find_elements(By.XPATH, selector)
    if elements:
        elements[0].click()
        break

💡 ポイント： 複数のセレクタを優先順位付きで試行するフォールバック設計は、実務のSeleniumテストでぜひ取り入れたい手法です。

④ 郵便番号フィールドの特定に手間取った

郵便番号フィールドを id で直接指定していたところ、サイトリニューアルで id が変わってテストが壊れました。完全一致より部分一致の方が変更に強いことを学びました。

# ❌ idの完全一致は変更に弱い
driver.find_element(By.ID, "zipCode1")

# ✅ name属性の部分一致で柔軟に対応
for inp in 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)

💡 ポイント： IDやクラス名の完全一致より、属性値の部分一致で探す方がサイト変更に強く、メンテナンスコストが下がります。

⑤ ログイン成否の判定が難しかった

ログイン後に「成功したかどうか」を判定する方法で悩みました。URLが変わらないケースもあり、ページタイトルやURLだけでは判定できない場面がありました。

# ❌ URLだけでは判定できないことがある
if "mypage" in driver.current_url:
    print("ログイン成功")

# ✅ ページ本文に含まれるテキストで判定
body_text = driver.find_element(By.TAG_NAME, "body").text
if "こんにちは" in body_text or "さん" in body_text:
    print("ログイン成功")

⚠️ 注意： 判定に使うテキストはサイトによって異なります。実際にログイン後のページを確認して、確実に表示されるテキストを選びましょう。

まとめ

本記事では、ヨドバシカメラの会員登録フォームを Python × Selenium で自動化するスクリプトを解説しました。

スクリプト実行後にデスクトップの yodobashi_signup_logs フォルダを開くと、ログファイルとスクリーンショットがタイムスタンプ付きで自動保存されています。これがそのままテストエビデンスとして活用できます。

yodobashi_signup_logsフォルダの中身。ログファイルとscreenshot_00〜03のPNGファイルが自動保存されている

▲ 自動保存されたログフォルダの中身。ログファイル＋スクリーンショット4枚がタイムスタンプ付きで整理されている

複数セレクタのフォールバック設計	XPathを複数パターン用意して堅牢な要素特定を実現
ログ＋スクリーンショット	実行履歴を追跡可能にすることでデバッグ工数を削減
登録→ログアウト→ログインの一貫フロー	登録完了だけでなくログイン可能状態まで検証
クラス設計による再利用性	各機能が独立したメソッドに分離されており拡張しやすい

QAエンジニアとして「毎回手動でフォームを埋めるのは限界」という課題に対し、実際の現場で使えるレベルの自動化を目指して設計しました。ぜひ GitHubのコードを参考に、あなたのプロジェクトに合わせてカスタマイズしてみてください！