要素の取得と基本アクション

要素の取得（Element Locating）

1. WebDriver が返す WebElement とは

• DOM 上の単一ノードを表す Selenium のオブジェクト。

• 取得後は 遅延評価（lazy evaluation）されるため、あとで実際に利用するときに DOM を再検索する点に注意。

2. 代表的なロケータ戦略（selenium.webdriver.common.by.By）

ベストプラクティス

1. ページ改修に強いロケータ（データ属性や安定したクラス）を用いる。

2. 取得後すぐに要素が可視・可操作とは限らないため、明示的待機（WebDriverWait + expected_conditions） を習慣化する。

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

email_box = WebDriverWait(driver, 10).until(
    EC.visibility_of_element_located((By.NAME, "email"))
)

---

基本アクション（Interactions）

1. クリック・入力系

キーボード定数（selenium.webdriver.common.keys.Keys）

python
from selenium.webdriver.common.keys import Keys
search_box.send_keys("Selenium", Keys.ENTER)

2. 属性・状態の取得

3. アクションチェーン（複合操作）

ActionChains によりマウスホバー、ドラッグ＆ドロップ、複数キー押下などをスクリプト的に連結可能。

python
from selenium.webdriver import ActionChains
actions = ActionChains(driver)
actions.move_to_element(menu).pause(0.5).click(sub_item).perform()

4. スクロール・JavaScript 実行

• 視野外要素のクリック時は JavaScript スクロールが必要になる場合がある。

• 例: driver.execute_script("arguments[0].scrollIntoView({block: 'center'});", target)

5. フォーム部品専用 API

---

失敗しないためのポイント

1. ページ遷移を伴う処理

   • 遷移後の要素を待たずに直接操作すると StaleElementReferenceException。必ず WebDriverWait で新しい要素を取得し直す。

2. 動的クラス名

   • React／Vue などの SPA ではクラス名がハッシュ化されることが多い。data-testid や安定 ID を開発チームに依頼する。

3. リトライ設計

   • ネットワーク遅延・アニメーション完了待ちなど環境要因でテストが不安定となる。

   • 共通ユーティリティとして再試行付きの safe_click を用意すると保守性が向上。

python
def safe_click(driver, locator, timeout=10):
    el = WebDriverWait(driver, timeout).until(
        EC.element_to_be_clickable(locator)
    )
    el.click()

4. テスト読みやすさ

   • ロケータをページオブジェクト（Page Object Pattern）に集約し、アクションはメソッドとして公開。

   • 例: LoginPage(driver).login("user", "pass")

---

まとめ

• 要素取得 は「安定したロケータ選定」+「明示的待機」が柱。

• 基本アクション は click()／send_keys()／clear()／get_attribute() を押さえ、複合操作は ActionChains。

• 実務では「DOM 変化」「非同期処理」に応じたエラーハンドリングを組み込み、再現性の高いスクリプトを目指すことが重要。