selenium

[Python] seleniumでドロップダウンを操作する方法

2025-01-18更新日: 2025-01-18

Seleniumでドロップダウンを操作するには、Selectクラスを使用します。

まず、webdriverでドロップダウン要素を取得し、その要素をSelectクラスに渡します。

次に、select_by_visible_text、select_by_value、またはselect_by_indexメソッドを使って、ドロップダウンの項目を選択します。

select_by_visible_textは表示されているテキストで選択し、select_by_valueはvalue属性で選択、select_by_indexはインデックス番号で選択します。

目次から探す

Seleniumでドロップダウンを操作する基本
ドロップダウンの選択方法
ドロップダウン操作の実装例
エラーハンドリング
応用例
まとめ

Seleniumでドロップダウンを操作する基本

Seleniumは、Webアプリケーションの自動テストを行うための強力なツールです。

その中でも、ドロップダウンメニューの操作は、ユーザーインターフェースのテストにおいて非常に重要な要素です。

ドロップダウンは、ユーザーが選択肢の中から一つまたは複数を選ぶためのインターフェースであり、Seleniumを使用することで、これらの選択肢をプログラムから操作することが可能です。

PythonでSeleniumを使用する際には、Selectクラスを利用してドロップダウンを操作します。

このクラスを使うことで、選択肢の表示名、値、インデックスを指定して選択することができます。

また、選択済みの項目を取得することもでき、テストの自動化に役立ちます。

以下では、具体的な操作方法や実装例について詳しく解説していきます。

ドロップダウンの選択方法

Seleniumを使用してドロップダウンを操作する際には、主にSelectクラスを利用します。

このクラスには、ドロップダウンの選択肢を操作するための便利なメソッドが用意されています。

以下では、具体的な選択方法について解説します。

select_by_visible_textを使った選択

select_by_visible_textメソッドは、ドロップダウンの選択肢の表示名を指定して選択する方法です。

以下はそのサンプルコードです。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('URL_OF_YOUR_PAGE')
# ドロップダウン要素を取得
dropdown = Select(driver.find_element_by_id('dropdown_id'))
# 表示名で選択
dropdown.select_by_visible_text('選択肢の表示名')

このコードを実行すると、指定した表示名の選択肢が選択されます。

select_by_valueを使った選択

select_by_valueメソッドは、ドロップダウンの選択肢の値を指定して選択する方法です。

以下はそのサンプルコードです。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('URL_OF_YOUR_PAGE')
# ドロップダウン要素を取得
dropdown = Select(driver.find_element_by_id('dropdown_id'))
# 値で選択
dropdown.select_by_value('選択肢の値')

このコードを実行すると、指定した値の選択肢が選択されます。

select_by_indexを使った選択

select_by_indexメソッドは、ドロップダウンの選択肢のインデックスを指定して選択する方法です。

以下はそのサンプルコードです。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('URL_OF_YOUR_PAGE')
# ドロップダウン要素を取得
dropdown = Select(driver.find_element_by_id('dropdown_id'))
# インデックスで選択
dropdown.select_by_index(0)  # 最初の選択肢を選択

このコードを実行すると、指定したインデックスの選択肢が選択されます。

選択済みの項目を取得する方法

選択済みの項目を取得するには、first_selected_optionメソッドを使用します。

以下はそのサンプルコードです。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('URL_OF_YOUR_PAGE')
# ドロップダウン要素を取得
dropdown = Select(driver.find_element_by_id('dropdown_id'))
# 選択済みの項目を取得
selected_option = dropdown.first_selected_option
print(selected_option.text)  # 選択された項目の表示名を出力

このコードを実行すると、現在選択されている項目の表示名が出力されます。

複数選択可能なドロップダウンの操作

複数選択可能なドロップダウンでは、select_by_visible_textやselect_by_valueメソッドを複数回使用して、複数の選択肢を選ぶことができます。

以下はそのサンプルコードです。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('URL_OF_YOUR_PAGE')
# ドロップダウン要素を取得
dropdown = Select(driver.find_element_by_id('dropdown_id'))
# 複数の選択肢を選択
dropdown.select_by_visible_text('選択肢1')
dropdown.select_by_visible_text('選択肢2')

このコードを実行すると、指定した複数の選択肢が選択されます。

選択済みの項目を取得する際は、optionsメソッドを使用して全ての選択肢を取得し、選択済みの項目を確認することができます。

ドロップダウン操作の実装例

ここでは、Seleniumを使用してドロップダウンを操作する具体的な実装例を紹介します。

各メソッドの使い方を理解するために、実際のコードを示します。

select_by_visible_textの実装例

select_by_visible_textメソッドを使用して、表示名でドロップダウンの選択肢を選ぶ例です。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
# ドロップダウン要素を取得
dropdown = Select(driver.find_element_by_id('dropdown_id'))
# 表示名で選択
dropdown.select_by_visible_text('オプション1')
# 選択結果を確認
print(f"選択されたオプション: {dropdown.first_selected_option.text}")
# WebDriverを終了
driver.quit()

このコードを実行すると、表示名「オプション1」が選択され、その結果が出力されます。

select_by_valueの実装例

select_by_valueメソッドを使用して、値でドロップダウンの選択肢を選ぶ例です。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
# ドロップダウン要素を取得
dropdown = Select(driver.find_element_by_id('dropdown_id'))
# 値で選択
dropdown.select_by_value('option1')
# 選択結果を確認
print(f"選択されたオプション: {dropdown.first_selected_option.text}")
# WebDriverを終了
driver.quit()

このコードを実行すると、値 option1 が選択され、その結果が出力されます。

select_by_indexの実装例

select_by_indexメソッドを使用して、インデックスでドロップダウンの選択肢を選ぶ例です。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
# ドロップダウン要素を取得
dropdown = Select(driver.find_element_by_id('dropdown_id'))
# インデックスで選択
dropdown.select_by_index(1)  # 2番目の選択肢を選択
# 選択結果を確認
print(f"選択されたオプション: {dropdown.first_selected_option.text}")
# WebDriverを終了
driver.quit()

このコードを実行すると、インデックス1(2番目の選択肢)が選択され、その結果が出力されます。

複数選択可能なドロップダウンの実装例

複数選択可能なドロップダウンで、複数の選択肢を選ぶ例です。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
# ドロップダウン要素を取得
dropdown = Select(driver.find_element_by_id('multi_select_dropdown_id'))
# 複数の選択肢を選択
dropdown.select_by_visible_text('オプション1')
dropdown.select_by_visible_text('オプション2')
# 選択結果を確認
selected_options = [option.text for option in dropdown.all_selected_options]
print(f"選択されたオプション: {selected_options}")
# WebDriverを終了
driver.quit()

このコードを実行すると、「オプション1」と「オプション2」が選択され、その結果が出力されます。

選択済みの項目を取得する実装例

選択済みの項目を取得する例です。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
# ドロップダウン要素を取得
dropdown = Select(driver.find_element_by_id('dropdown_id'))
# 表示名で選択
dropdown.select_by_visible_text('オプション1')
# 選択済みの項目を取得
selected_option = dropdown.first_selected_option
print(f"選択されたオプション: {selected_option.text}")
# WebDriverを終了
driver.quit()

このコードを実行すると、選択された項目の表示名が出力されます。

これにより、選択肢の確認が容易になります。

エラーハンドリング

Seleniumを使用してドロップダウンを操作する際には、さまざまなエラーが発生する可能性があります。

これらのエラーに適切に対処することで、スクリプトの安定性を向上させることができます。

以下では、一般的なエラーとその対処法について解説します。

ドロップダウンが見つからない場合の対処法

ドロップダウン要素が見つからない場合、NoSuchElementExceptionが発生します。

このエラーを回避するためには、要素が存在するまで待機することが重要です。

以下はそのサンプルコードです。

from selenium import webdriver
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
try:
    # ドロップダウン要素が見つかるまで待機
    dropdown = WebDriverWait(driver, 10).until(
        EC.presence_of_element_located((By.ID, 'dropdown_id'))
    )
except Exception as e:
    print(f"エラーが発生しました: {e}")
finally:
    driver.quit()

このコードでは、ドロップダウン要素が見つかるまで最大10秒間待機します。

項目が存在しない場合のエラー処理

選択しようとしている項目が存在しない場合、NoSuchElementExceptionが発生します。

このエラーを処理するためには、選択肢が存在するかどうかを確認することが重要です。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
from selenium.common.exceptions import NoSuchElementException
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
dropdown = Select(driver.find_element_by_id('dropdown_id'))
try:
    dropdown.select_by_visible_text('存在しないオプション')
except NoSuchElementException:
    print("指定したオプションは存在しません。")
driver.quit()

このコードでは、存在しないオプションを選択しようとした場合にエラーメッセージを表示します。

タイムアウトエラーの対処法

要素が見つからない場合や、操作が完了するまでの時間が長すぎる場合、タイムアウトエラーが発生します。

これを防ぐためには、適切な待機時間を設定することが重要です。

from selenium import webdriver
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
try:
    # ドロップダウン要素が見つかるまで待機
    dropdown = WebDriverWait(driver, 10).until(
        EC.presence_of_element_located((By.ID, 'dropdown_id'))
    )
    # 操作を実行
    dropdown.select_by_visible_text('オプション1')
except Exception as e:
    print(f"タイムアウトエラーが発生しました: {e}")
finally:
    driver.quit()

このコードでは、要素が見つからない場合にタイムアウトエラーをキャッチし、エラーメッセージを表示します。

NoSuchElementExceptionの対処法

NoSuchElementExceptionは、指定した要素が見つからない場合に発生します。

このエラーを処理するためには、要素が存在するかどうかを確認し、適切なエラーメッセージを表示することが重要です。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
from selenium.common.exceptions import NoSuchElementException
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
try:
    dropdown = Select(driver.find_element_by_id('dropdown_id'))
    dropdown.select_by_visible_text('オプション1')
except NoSuchElementException:
    print("ドロップダウン要素が見つかりません。")
except Exception as e:
    print(f"エラーが発生しました: {e}")
finally:
    driver.quit()

このコードでは、NoSuchElementExceptionが発生した場合にエラーメッセージを表示し、他のエラーもキャッチして処理します。

これにより、スクリプトの安定性が向上します。

応用例

Seleniumを使用してドロップダウンを操作する際には、さまざまな状況に応じた応用が可能です。

以下では、特定のシナリオにおけるドロップダウン操作の実装例を紹介します。

動的に生成されるドロップダウンの操作

動的に生成されるドロップダウンは、ページの読み込み後にJavaScriptによって生成されることがあります。

この場合、要素が生成されるまで待機する必要があります。

from selenium import webdriver
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
# ドロップダウンが動的に生成されるのを待機
dropdown = WebDriverWait(driver, 10).until(
    EC.presence_of_element_located((By.ID, 'dynamic_dropdown_id'))
)
# ドロップダウンを操作
select = Select(dropdown)
select.select_by_visible_text('動的オプション')
# 結果を確認
print(f"選択されたオプション: {select.first_selected_option.text}")
driver.quit()

このコードでは、動的に生成されるドロップダウンが表示されるまで待機し、その後選択肢を選びます。

JavaScriptで制御されるドロップダウンの操作

JavaScriptで制御されるドロップダウンは、通常の方法では操作できない場合があります。

この場合、JavaScriptを直接実行して操作することができます。

from selenium import webdriver
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
# JavaScriptを使用してドロップダウンを操作
driver.execute_script("document.getElementById('dropdown_id').value = 'option_value';")
# 結果を確認
selected_value = driver.execute_script("return document.getElementById('dropdown_id').value;")
print(f"選択されたオプション: {selected_value}")
driver.quit()

このコードでは、JavaScriptを使用してドロップダウンの値を直接設定し、その結果を確認します。

非同期処理を伴うドロップダウンの操作

非同期処理を伴うドロップダウンでは、選択肢が非同期で更新されることがあります。

この場合も、要素が更新されるまで待機する必要があります。

from selenium import webdriver
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
# 非同期処理でドロップダウンが更新されるのを待機
dropdown = WebDriverWait(driver, 10).until(
    EC.presence_of_element_located((By.ID, 'async_dropdown_id'))
)
# ドロップダウンを操作
select = Select(dropdown)
select.select_by_visible_text('非同期オプション')
# 結果を確認
print(f"選択されたオプション: {select.first_selected_option.text}")
driver.quit()

このコードでは、非同期処理によって更新されるドロップダウンを待機し、選択肢を選びます。

ドロップダウンの選択肢を取得して表示する方法

ドロップダウンの選択肢を取得して表示する方法です。

from selenium import webdriver
from selenium.webdriver.support.ui import Select
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
# ドロップダウン要素を取得
dropdown = Select(driver.find_element_by_id('dropdown_id'))
# 選択肢を取得して表示
options = dropdown.options
for option in options:
    print(f"選択肢: {option.text}")
driver.quit()

このコードを実行すると、ドロップダウンの全ての選択肢が表示されます。

ドロップダウンの選択肢を動的に変更する方法

ドロップダウンの選択肢を動的に変更する場合、JavaScriptを使用して新しい選択肢を追加することができます。

from selenium import webdriver
# WebDriverの初期化
driver = webdriver.Chrome()
driver.get('https://example.com')  # テスト用のURLに置き換えてください
# JavaScriptを使用してドロップダウンに新しい選択肢を追加
driver.execute_script("var select = document.getElementById('dropdown_id');"
                      "var option = document.createElement('option');"
                      "option.value = 'new_option_value';"
                      "option.text = '新しいオプション';"
                      "select.add(option);")
# 結果を確認
options = driver.execute_script("return document.getElementById('dropdown_id').options;")
for option in options:
    print(f"選択肢: {option.text}")
driver.quit()