【実務レベル】Selenium×pytest完全ガイド｜fixture・parametrize・markを体系解説

Selenium × pytest でよく使う4つの機能——fixture・parametrize・conftest.py・mark——を、サンプルコード付きで解説します。

pytest の fixture・parametrize・mark を使いこなせるようになると、Selenium テストを「単発スクリプト」から「保守しやすいテストスイート」へ改善できます。

この記事では、実務でそのまま使える構成をコード付きで紹介します。

👉 前提：Selenium × Python の環境構築が完了していることを前提にしています。まだの方は 環境構築ガイド を先にご確認ください。

Selenium のテストは「とりあえず動く」から「チームで使える・CIで回せる」レベルへの壁があります。その壁を超えるのが pytest の fixture・parametrize・mark の使いこなしです。

Selenium × pytest の全体構成とは？

フォルダ構成

まず全体のフォルダ構成と各ファイルの役割を把握します。

selenium-project/
├── venv/
├── tests/
│   ├── conftest.py          # WebDriver fixture・共通設定
│   ├── test_login.py        # ログインテスト
│   ├── test_search.py       # 検索テスト
│   └── test_register.py     # 会員登録テスト
├── pages/
│   └── login_page.py        # Page Object（別記事で解説します）
├── requirements.txt
└── pytest.ini

各ファイルの役割

STEP 1：pytest fixture とは？conftest.py で WebDriver を共通化する

conftest.py に WebDriver の fixture を定義することで、全テストファイルで共有できます。

# tests/conftest.py
import pytest
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.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager

@pytest.fixture(scope="function")
def driver():
    """テストごとにChromeを起動・終了するfixture"""
    options = webdriver.ChromeOptions()
    # options.add_argument("--headless")  # CI/CD環境ではオンにする
    options.add_argument("--no-sandbox")            # Linux/CI環境用
    options.add_argument("--disable-dev-shm-usage") # Linux/CI環境用
    options.add_argument("--window-size=1920,1080")

    service = Service(ChromeDriverManager().install())
    driver = webdriver.Chrome(service=service, options=options)
    driver.implicitly_wait(10)  # 要素検索時の基本待機を設定（補助的な用途）

    yield driver

    try:
        driver.quit()
    except Exception:
        pass  # セッション切断済みでも teardown が失敗しないよう保護


@pytest.fixture(scope="function")
def logged_in_driver(driver):
    """ログイン状態が必要なテスト専用fixture。
    ログイン不要なテストには driver fixture を直接使うこと。"""
    # ※ example-app.com はサンプルURLです。実際のテスト対象URLに置き換えてください。
    driver.get("https://example-app.com/login")
    driver.find_element(By.ID, "username").send_keys("test_user")
    driver.find_element(By.ID, "password").send_keys("test_pass")
    driver.find_element(By.ID, "login-btn").click()

    # ログイン完了を待機（これがないとCI環境で不安定になる）
    WebDriverWait(driver, 10).until(
        EC.url_contains("/dashboard")
    )

    yield driver
    # teardown（driver.quit()）は driver fixture 側で行うため、ここでは不要

# ログイン状態が必要なテストだけ logged_in_driver を使う
def test_dashboard_title(logged_in_driver):
    """ログイン後のダッシュボードタイトルを確認"""
    assert "ダッシュボード" in logged_in_driver.title

# ログイン不要なテストは driver を直接使う
def test_top_page_title(driver):
    """トップページのタイトルを確認（ログイン不要）"""
    driver.get("https://example-app.com")
    assert "トップページ" in driver.title

STEP 2：基本的なテストの書き方（正常系・異常系）

base_url fixture を引数で受け取ることで URL を一元管理できます。定数との混在がなくなり、環境ごとの切り替えも fixture 側だけで対応できます。

# tests/test_login.py
# ※ 以降のコードでも同じ import を使用します
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# ── 正常系 ─────────────────────────────────────────
def test_login_success(driver, base_url):
    """正常系：正しいID・PWでログイン成功する"""
    driver.get(f"{base_url}/login")

    driver.find_element(By.ID, "username").send_keys("valid_user")
    driver.find_element(By.ID, "password").send_keys("valid_pass")
    driver.find_element(By.ID, "login-btn").click()

    WebDriverWait(driver, 10).until(
        EC.url_contains("/dashboard")
    )
    assert "/dashboard" in driver.current_url

# ── 異常系 ─────────────────────────────────────────
def test_login_failure_wrong_password(driver, base_url):
    """異常系：パスワードが間違っている場合にエラーメッセージが表示される"""
    driver.get(f"{base_url}/login")

    driver.find_element(By.ID, "username").send_keys("valid_user")
    driver.find_element(By.ID, "password").send_keys("wrong_pass")
    driver.find_element(By.ID, "login-btn").click()

    error_msg = WebDriverWait(driver, 10).until(
        EC.visibility_of_element_located(
            (By.CSS_SELECTOR, "[data-testid='login-error']")  # data-testid 推奨
        )
    )
    assert "パスワードが正しくありません" in error_msg.text

def test_login_failure_empty_fields(driver, base_url):
    """異常系：IDとPWが空のまま送信するとバリデーションエラーが出る"""
    driver.get(f"{base_url}/login")
    driver.find_element(By.ID, "login-btn").click()

    error = WebDriverWait(driver, 10).until(
        EC.visibility_of_element_located((By.CLASS_NAME, "validation-error"))
    )
    assert error.is_displayed()

STEP 3：pytest parametrize によるデータ駆動テストの実装

@pytest.mark.parametrize を使うと、同じテストロジックを複数のデータで繰り返し実行できます。異常系のパターンが多い場合に特に効果的です。

# tests/test_login.py（続き）
import pytest
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# テストデータをリストで定義
INVALID_LOGIN_CASES = [
    ("", "valid_pass", "ユーザー名を入力してください"),          # ID空
    ("valid_user", "", "パスワードを入力してください"),          # PW空
    ("wrong_user", "valid_pass", "認証に失敗しました"),          # ID間違い
    ("valid_user", "wrong_pass", "パスワードが正しくありません"),  # PW間違い
    ("a" * 256, "valid_pass", "入力値が長すぎます"),             # ID最大長超過
]

@pytest.mark.parametrize("username, password, expected_error", INVALID_LOGIN_CASES)
def test_login_validation(driver, base_url, username, password, expected_error):
    """parametrize：複数の異常系パターンをまとめてテスト"""
    driver.get(f"{base_url}/login")  # base_url fixture で統一

    driver.find_element(By.ID, "username").send_keys(username)
    driver.find_element(By.ID, "password").send_keys(password)
    driver.find_element(By.ID, "login-btn").click()

    error_msg = WebDriverWait(driver, 10).until(
        EC.visibility_of_element_located((By.CLASS_NAME, "error-message"))
    )
    assert expected_error in error_msg.text

実行結果サンプル

pytest tests/test_login.py -v

collected 8 items

test_login.py::test_login_success                                     PASSED
test_login.py::test_login_failure_wrong_password                      PASSED
test_login.py::test_login_failure_empty_fields                        PASSED
test_login.py::test_login_validation[-valid_pass-ユーザー名を入力してください]  PASSED
test_login.py::test_login_validation[valid_user--パスワードを入力してください]  PASSED
test_login.py::test_login_validation[wrong_user-valid_pass-認証に失敗しました] PASSED
test_login.py::test_login_validation[valid_user-wrong_pass-パスワードが…]     PASSED
test_login.py::test_login_validation[aaaa…-valid_pass-入力値が長すぎます]     PASSED

========================== 8 passed in 18.34s ==========================

STEP 4：pytest mark でテストを分類・選択実行する

@pytest.mark を使うとテストにタグを付けて、特定のグループだけ選んで実行できます。CI/CD で「スモークテストだけ実行」「全テストを実行」と使い分けるときに必須です。

pytest.ini にカスタム mark を登録

[pytest]
testpaths = tests
addopts = -v
markers =
    smoke: スモークテスト（最重要・毎回実行）
    regression: リグレッションテスト（全体確認時に実行）
    slow: 実行に時間がかかるテスト

テストに mark を付ける

# tests/test_login.py
import pytest

@pytest.mark.smoke
def test_login_success(driver):
    """スモークテスト：正常ログインは最優先で確認"""
    ...

@pytest.mark.regression
def test_login_failure_wrong_password(driver):
    """リグレッション：パスワード間違いのエラー表示確認"""
    ...

@pytest.mark.slow
@pytest.mark.regression
def test_login_session_timeout(driver):
    """遅いテスト：セッションタイムアウトの動作確認"""
    ...

mark を指定して実行

# スモークテストだけ実行（デプロイ後の確認に）
pytest -m smoke

# リグレッションテストだけ実行（リリース前に）
pytest -m regression

# 遅いテストを除いて実行
pytest -m "not slow"

# スモーク かつ リグレッション
pytest -m "smoke and regression"

STEP 5：fixture の応用（セットアップ・ティアダウン）

fixture を使うと「テスト前後の処理」を一元管理できます。

# tests/conftest.py（追加）
import pytest

@pytest.fixture(scope="function")
def go_to_login(driver):
    """ログインページに移動するfixture"""
    driver.get("https://example-app.com/login")
    yield driver
    # ティアダウン：テスト後にスクリーンショットを保存（失敗時のデバッグ用）
    import os
    import time
    os.makedirs("screenshots", exist_ok=True)  # フォルダがなければ作成
    # タイムスタンプでファイル名を生成（タイトルの特殊文字・日本語によるエラーを防ぐ）
    # ※ 実務では pytest hook（pytest_runtest_makereport）を使って失敗時のみ保存する構成が一般的です
    driver.save_screenshot(f"screenshots/{int(time.time())}.png")


@pytest.fixture(scope="session")
def base_url():
    """ベースURLをfixture化（環境ごとに切り替えやすくなる）
    ※ これにより BASE_URL 定数は不要。全テストで base_url fixture を使うこと。"""
    return "https://example-app.com"  # ※ サンプルURLです。実際のURLに置き換えてください

# conftest.py に追加
import os, re, pytest

@pytest.hookimpl(hookwrapper=True)
def pytest_runtest_makereport(item, call):
    outcome = yield
    report = outcome.get_result()
    if report.when == "call" and report.failed:
        driver = item.funcargs.get("driver")
        if driver:
            os.makedirs("screenshots", exist_ok=True)
            # Windows禁止文字をまとめて除去（\ / * ? : " < > |）
            safe_name = re.sub(r'[\\/*?:"<>|]', "_", item.name)
            driver.save_screenshot(f"screenshots/{safe_name}.png")

# fixture を組み合わせて使う
def test_login_page_title(go_to_login, base_url):
    """ログインページのタイトルを確認"""
    assert "ログイン" in go_to_login.title
    assert base_url in go_to_login.current_url

STEP 6：実践的なテスト例（会員登録フォーム）

これまで学んだ fixture・parametrize・mark を組み合わせた実践例です。

# tests/test_register.py
import pytest
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# 正常系データ
# ※ 実案件では同じメールアドレスを繰り返すと重複登録エラーになります
# テストごとにユニーク化する場合は f"test_{int(time.time())}@example.com" を使いましょう
VALID_USER = {
    "name": "テスト太郎",
    "email": "test@example.com",
    "password": "SecurePass123!",
}

# バリデーション異常系データ
VALIDATION_CASES = [
    ("name", "", "お名前を入力してください"),
    ("email", "not-an-email", "正しいメールアドレスを入力してください"),
    ("email", "", "メールアドレスを入力してください"),
    ("password", "short", "パスワードは8文字以上で入力してください"),
]

@pytest.fixture
def register_page(driver, base_url):
    """会員登録ページに移動するfixture（base_url fixture と組み合わせて URL を統一）"""
    driver.get(f"{base_url}/register")
    yield driver


@pytest.mark.smoke
def test_register_success(register_page):
    """スモーク：正常な会員登録が完了する"""
    d = register_page
    d.find_element(By.ID, "name").send_keys(VALID_USER["name"])
    d.find_element(By.ID, "email").send_keys(VALID_USER["email"])
    d.find_element(By.ID, "password").send_keys(VALID_USER["password"])
    d.find_element(By.ID, "submit-btn").click()

    success = WebDriverWait(d, 10).until(
        EC.visibility_of_element_located((By.CLASS_NAME, "success-message"))
    )
    assert "登録が完了しました" in success.text


@pytest.mark.regression
@pytest.mark.parametrize("field, value, expected_error", VALIDATION_CASES)
def test_register_validation(register_page, field, value, expected_error):
    """リグレッション：バリデーションエラーのパターンテスト"""
    d = register_page

    # 有効な値でフォームを埋めてから対象フィールドだけ変更
    d.find_element(By.ID, "name").send_keys(VALID_USER["name"])
    d.find_element(By.ID, "email").send_keys(VALID_USER["email"])
    d.find_element(By.ID, "password").send_keys(VALID_USER["password"])

    # 対象フィールドをクリアして異常値を入力
    target = d.find_element(By.ID, field)
    target.clear()
    target.send_keys(value)
    d.find_element(By.ID, "submit-btn").click()

    error = WebDriverWait(d, 10).until(
        # By.ID でフィールドごとのエラー要素を特定（field-error より精度が高い）
        EC.visibility_of_element_located((By.ID, f"{field}-error"))
    )
    assert expected_error in error.text

⚠️ よくあるはまりポイント7選

Selenium × pytest を使い始めたときに詰まりやすいポイントをまとめました。

tests/
├── conftest.py   ← ここに置く（tests/ 直下）
└── test_login.py

[pytest]
markers =
    smoke: スモークテスト
    regression: リグレッションテスト

# NG
cd tests && pytest

# OK
cd selenium-project  # プロジェクトルートで
pytest

FAQ

この記事の手順を一通り実装すれば、テスト設計とテスト実装が明確に分離された、保守しやすいテストスイートが完成します。

📋 この記事のまとめ

まずは parametrize を使って既存のテストのデータを切り出すことから始めてみてください。たった1つのパターンを実装するだけで「テスト設計」と「テスト実装」が分離され、テストスイート全体の見通しが一気によくなります。