ページオブジェクトモデルへの書き換え

1. ページオブジェクトモデル（POM）とは何か

---

2. 既存スクリプトから POM へ書き換える全体フロー

1. ページ（または機能）単位に現行テストを棚卸し

   • 画面遷移図や UI マップを作成し、要素と操作の対応関係を整理

2. ページクラスのスケルトンを作成

   • URL／主要要素／代表操作をメソッドとして列挙

3. ロケーターと操作メソッドの移植

   • 既存テストから driver.find_element... のロジックを移し替え

4. テストケース側でページクラスを呼び出すようリファクタ

   • 旧ロケーター呼出しを削除し、LoginPage.login(user, pass) などへ置換

5. 共通処理の抽出とユーティリティ統合

   • 待機・例外処理を BasePage / ヘルパーにまとめる

6. CI パイプラインで段階的に回帰

   • テストグループを分割し、POM 化ブランチを順次統合

---

3. スケルトン例

BasePage（Python）

python
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

class BasePage:
    TIMEOUT = 10

    def __init__(self, driver):
        self.driver = driver

    def wait_visible(self, locator):
        return WebDriverWait(self.driver, self.TIMEOUT).until(
            EC.visibility_of_element_located(locator)
        )

LoginPage（Python）

python
from selenium.webdriver.common.by import By
from .base_page import BasePage

class LoginPage(BasePage):
    URL = "https://example.com/login"
    _USERNAME = (By.ID, "username")
    _PASSWORD = (By.ID, "password")
    _SUBMIT   = (By.CSS_SELECTOR, "button[type='submit']")

    # アクション
    def open(self):
        self.driver.get(self.URL)

    def login(self, user, pwd):
        self.wait_visible(self._USERNAME).send_keys(user)
        self.driver.find_element(*self._PASSWORD).send_keys(pwd)
        self.driver.find_element(*self._SUBMIT).click()
        # 戻り値で遷移後ページを返すとチェーンが容易
        from .dashboard_page import DashboardPage
        return DashboardPage(self.driver)

LoginTest（pytest）

python
def test_login_success(driver, credentials):
    login = LoginPage(driver)
    dashboard = login.open().login(credentials.user, credentials.password)
    assert dashboard.is_loaded()

---

4. 言語別ベストプラクティス

---

5. インクリメンタル・マイグレーション戦略

1. 高変更頻度ページから着手

   • 既存テストで最も“壊れやすい”部分を優先

2. Facade クラスで旧 API をラップ

   • 一度に大量書き換えせず、旧テストも動かし続ける

3. CI 上で A/B 実行

   • 同一シナリオを旧・新双方で実行し結果差分をチェック

4. リント＆コードカバレッジ閾値を設定

   • 粗いコードの混入防止、リファクタ効果を定量把握

---

6. よくある落とし穴と回避策

---

7. 付随メリット

• IDE 補完の質向上
  要素名がメソッド化されるため、テストケース上で誤入力が減少

• ドメイン用語の共有辞書化
  CheckoutPage.placeOrder() のようにビジネスプロセスがコード名へ直結し、非開発者レビューが容易

• 再利用率の向上
  同一操作を複数シナリオで呼び回せるため、新規シナリオ追加の工数が削減

---

8. まとめ

既存 Selenium スクリプトをページオブジェクトモデルへ書き換えることで、保守コストの最小化とテストコードのドメイン化を両立できます。
ポイントは「画面 ≒ クラス、操作 ≒ メソッド」という単純明快な対応付けを保ちながら、待機・エラーハンドリングを共通化することです。段階的な移行と CI の並走を徹底し、アンチパターンに陥らないよう小さな単位でリファクタを進めていきましょう。