閉じる

Seleniumでページ遷移を確実に待機する方法：URL変化をトリガーにした実装テクニック

広告

Webブラウザの自動操作において、最も頻繁に発生し、かつエラーの原因になりやすいのが「ページ遷移の待機」です。

現代のWebアプリケーションは非同期通信を多用しており、従来のページ読み込み完了を待つだけでは不十分なケースが増えています。

特にシングルページアプリケーション（SPA）では、画面の見た目が変わっても内部的な処理が追いついていないことが多々あります。

本記事では、Seleniumを使用してURLの変化を正確に検知し、確実にページ遷移を待機する実装テクニックを紹介します。

2026年現在の最新のベストプラクティスを取り入れ、安定したスクレイピングやテストコードの作成を目指しましょう。

目次 [ close ]
  1. ページ遷移待機の重要性とSeleniumの仕組み
    1. 暗黙的な待機（Implicit Wait）の限界
    2. 明示的な待機（Explicit Wait）の優位性
  2. URL変化をトリガーにした待機方法
    1. URLを監視するための主要なメソッド
  3. 実装：ボタンクリック後のURL変化を待機する
  4. 非同期処理（Ajax）による部分遷移への対応
  5. ページ遷移待機で発生するトラブルと対策
    1. TimeoutExceptionが発生する場合
    2. URLにクエリパラメータが含まれる場合
    3. 遷移前のページに留まってしまう場合
  6. 正規表現を用いた高度なURL待機
  7. まとめ

ページ遷移待機の重要性とSeleniumの仕組み

Seleniumでブラウザを操作する際、コマンドを送る速度は人間の操作よりもはるかに高速です。

ボタンをクリックした直後に次の操作を実行しようとすると、遷移先の要素がまだ読み込まれておらず、NoSuchElementExceptionなどのエラーが発生します。

これを防ぐためには、プログラム側で「遷移が完了するまで待つ」という処理を明示的に記述しなければなりません。

暗黙的な待機（Implicit Wait）の限界

Seleniumには、要素が見つかるまで一定時間待機する「暗黙的な待機」という設定があります。

しかし、暗黙的な待機はすべての要素に対して一律の時間を設定するため、特定の条件に基づいた柔軟な制御が困難です。

また、要素自体は存在していても、ページ遷移の途中で古い要素を掴んでしまい、StaleElementReferenceExceptionを引き起こすリスクもあります。

明示的な待機（Explicit Wait）の優位性

そこで推奨されるのが、特定の条件が満たされるまで待機する「明示的な待機」です。

明示的な待機を用いることで、「URLが特定のものに変わるまで待つ」といった高度な制御が可能になります。

これにより、ネットワークの遅延やレンダリングの負荷に関わらず、安定した自動操作を実現できます。

URL変化をトリガーにした待機方法

ページ遷移を検知する最も確実な方法の一つは、ブラウザのURLが変化したかどうかを監視することです。

Seleniumのexpected_conditionsモジュールには、URLの状態を確認するための便利なメソッドが用意されています。

URLを監視するための主要なメソッド

目的に応じて、以下の表にあるメソッドを使い分けましょう。

メソッド名待機条件の詳細
url_to_beURLが指定した文字列と完全に一致するまで待機します。
url_containsURLの中に指定した文字列が含まれるまで待機します。
url_changes現在のURLが指定したURLから変化するまで待機します。
url_matchesURLが指定した正規表現パターンに一致するまで待機します。

これらのメソッドを適切に選択することで、動的なURL遷移にも柔軟に対応できるようになります。

実装：ボタンクリック後のURL変化を待機する

具体的なPythonコードを用いて、ページ遷移を待機する実装例を見ていきましょう。

ここでは、ログインボタンをクリックした後にトップページへ遷移することを想定したコードを記述します。

Python
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

# WebDriverのセットアップ
driver = webdriver.Chrome()

try:
    # ログインページへアクセス
    driver.get("https://example.com/login")

    # 遷移前のURLを保存
    old_url = driver.current_url

    # ログイン情報を入力し、ボタンをクリック
    driver.find_element(By.ID, "username").send_keys("testuser")
    driver.find_element(By.ID, "password").send_keys("password123")
    driver.find_element(By.ID, "submit-button").click()

    # 最大10秒間、URLが変化するのを待機
    wait = WebDriverWait(driver, 10)
    wait.until(EC.url_changes(old_url))

    # または、特定のURLに遷移したことを確認
    wait.until(EC.url_contains("/dashboard"))

    print("ページ遷移が正常に完了しました。")
    print(f"現在のURL: {driver.current_url}")

finally:
    driver.quit()
実行結果
ページ遷移が正常に完了しました。
現在のURL: https://example.com/dashboard

このコードでは、まずurl_changesを使用して、クリック前のURLから変化したことを確認しています。

その後、url_containsを使い、遷移後のURLに特定の文字列（/dashboard）が含まれているかを判定しています。

このように二段構えでチェックを行うことで、遷移の失敗を確実に検知できます。

非同期処理（Ajax）による部分遷移への対応

最近のWebサイトでは、ページ全体をリロードせずにURLだけを書き換える「History API」を利用した遷移が多く見られます。

この場合、ブラウザの読み込みアイコン（スピナー）が回転しないため、通常の読み込み待機では検知できません。

しかし、Seleniumのurl_to_beやurl_changesは、ブラウザのアドレスバーにあるURL自体を監視しているため、こうしたSPAの遷移にも対応可能です。

ただし、URLが変わった直後はDOMの構築が完了していない場合があるため、URLの待機と同時に「特定の要素が表示されるまで待つ」処理を組み合わせるのが鉄則です。

Python
# URLの変化を待機
wait.until(EC.url_contains("/dashboard"))

# さらに、遷移後の重要な要素が表示されるまで待機
wait.until(EC.visibility_of_element_id((By.ID, "welcome-message")))

このように複数の条件を組み合わせることで、自動操作の堅牢性が劇的に向上します。

ページ遷移待機で発生するトラブルと対策

URLによる待機を実装していても、予期せぬエラーに遭遇することがあります。

ここでは代表的なトラブルとその解決策を解説します。

TimeoutExceptionが発生する場合

設定した秒数以内にURLが変化しなかった場合、TimeoutExceptionがスローされます。

この原因の多くは、ネットワークの遅延、あるいはボタンのクリック自体が成功していないことです。

対策として、クリック処理が確実に行われたかを確認するか、待機時間を少し長めに設定（例：10秒から20秒へ）することを検討してください。

URLにクエリパラメータが含まれる場合

遷移後のURLに?session_id=12345のような動的なパラメータが付与されることがあります。

この場合、url_to_beによる完全一致の比較では、パラメータが異なるたびに待機が失敗してしまいます。

こうした状況では、部分一致で判定できる「url_contains」を使用するのが最適です。

遷移前のページに留まってしまう場合

バリデーションエラーなどで遷移が発生しなかった場合、プログラムはURLが変わるのを待ち続け、最終的にタイムアウトします。

これを防ぐには、try-except構文を用いてタイムアウトをキャッチし、エラーメッセージが表示されていないかを確認するロジックを追加すると良いでしょう。

正規表現を用いた高度なURL待機

URLの構造が複雑で、複数のパターンが考えられる場合は、url_matchesと正規表現を組み合わせると便利です。

例えば、ユーザーIDがURLに含まれる場合（/user/123/profileなど）の待機は以下のように記述します。

Python
import re

# 正規表現で「/user/数字/profile」の形式を待機
pattern = r"https://example\.com/user/\d+/profile"
wait.until(EC.url_matches(pattern))

正規表現を活用することで、動的なIDが含まれるURLへの遷移も正確にトラッキングできます。

まとめ

Seleniumを用いたブラウザ自動操作において、URLの変化をトリガーにした待機処理は非常に強力な武器となります。

「暗黙的な待機」に頼るのではなく、WebDriverWaitとexpected_conditionsを活用した「明示的な待機」を基本に据えましょう。

本記事で紹介したurl_changesやurl_contains、そして要素の表示待機を組み合わせる手法は、2026年現在も最も安定性の高い実装方法です。

遷移のタイミングを正確に制御することで、エラーの少ないスムーズな自動化を実現してください。

URLをコピーしました！