1. 要素検索の基本
要素検索の方法
コードに飛び込む前に、まずSeleniumを使ってWebページ上の要素をどのように検索するのかを理解しておくことが大切だね。 Seleniumにはいくつか便利な方法が用意されていて、要素を探すことができるんだ:
-
find_element_by_id(): 要素をそのユニークな識別子(id)で検索する。 -
find_element_by_name(): 要素をそのname属性で見つける。 -
find_element_by_class_name(): 特定のクラス(class)を持つ要素を検索する。 -
find_element_by_tag_name(): タグ名を使って要素を検索する。例えば、div、p、a。
重要: これは Selenium 3 の書き方です。Selenium 4 ではこれらのメソッドは削除されました。By を使う現在の書き方は次のセクションで説明します。
最初は簡単な例から始めよう。idを使った要素の検索だよ。例えば「魔法のボタン」というラベルを持つボタンを探してみよう:
from selenium import webdriver
# ドライバの設定とブラウザを開く
driver = webdriver.Chrome()
driver.get('https://example.com')
# idで要素を検索する
magic_button = driver.find_element_by_id('magic_button_id')
# 見つけた要素を操作する(例: テキストを取得)
print(magic_button.text)
# セッションを終了する
driver.quit()
見つけた要素の操作
要素を見つけたら次はどうするかを決める番だね。Seleniumのメソッド、たとえばtextで要素のテキスト内容を取得したり、 get_attribute('attribute_name')で要素の特定の属性値を取得したりできるよ。
例えば、リンク要素があったとして、そのリンク先を知りたい場合はどうするのか、こうやればいいよ:
# リンク要素を検索する
link_element = driver.find_element_by_class_name('link_class')
# href属性からURLを取得する
link_url = link_element.get_attribute('href')
print(f'このリンク先は: {link_url}')
2. Selenium 4: By を使う現在の検索方法
この講義でこれ以降に説明する内容は、すべて従来の Selenium 3 の書き方です。Selenium 4 では find_element_by_* メソッドはまず非推奨とされ、Selenium 4.3.0 以降は完全に削除されました。最新版のライブラリでこのコードを実行すると AttributeError が発生します。
個別のメソッド群の代わりに、汎用的な find_element() が1つだけ残りました。第1引数には By クラスの検索方法を、第2引数には値そのものを渡します。By クラスは別途インポートする必要があります:
from selenium.webdriver.common.by import By
対応表
| Selenium 3 | Selenium 4 | 動作 |
|---|---|---|
find_element_by_id('magic_button_id') |
find_element(By.ID, 'magic_button_id') |
要素をそのユニークな識別子(id)で検索する。 |
find_element_by_name('name') |
find_element(By.NAME, 'name') |
要素をそのname属性で見つける。 |
find_element_by_class_name('class') |
find_element(By.CLASS_NAME, 'class') |
特定のクラス(class)を持つ要素を検索する。 |
find_element_by_tag_name('tag') |
find_element(By.TAG_NAME, 'tag') |
タグ名を使って要素を検索する。例えば、div、 p、a。 |
条件に合うすべての要素を探す方法も同じように変わりました。find_elements_by_*() の代わりに、同じ By の指定を受け取る find_elements() が1つあるだけです。上の4つのほかに、By クラスには By.XPATH、By.CSS_SELECTOR、By.LINK_TEXT、By.PARTIAL_LINK_TEXT もあります。これらは次回以降の講義で扱います。
同じ例を Selenium 4 で書くと
from selenium import webdriver
from selenium.webdriver.common.by import By
# ドライバの設定とブラウザを開く
driver = webdriver.Chrome()
driver.get('https://example.com')
# idで要素を検索する
magic_button = driver.find_element(By.ID, 'magic_button_id')
# 見つけた要素を操作する(例: テキストを取得)
print(magic_button.text)
# セッションを終了する
driver.quit()
ご覧のとおり、変わったのは検索の行だけです。それ以外はまったく同じように動作し、メソッドは同じ要素オブジェクトを返すので、text、get_attribute()、click()、send_keys() もそのまま使えます。
この先の講義では、各メソッドを従来の find_element_by_* の形で説明します。古いコードや一部の練習課題では、まさにこの形で登場するからです。Selenium 4 へ移すときは、上の対応表どおりに機械的に置き換えるだけで済みます。
3. メソッド find_element_by_id()
find_element_by_id() メソッドは、Webページ上の要素を検索する最速かつ確実な方法のひとつだよ。 このメソッドは、要素をユニークなid属性で探すことができるから。HTMLではid属性が一意の識別子だから、 このメソッドは特定の要素を1つだけ返すことを保証するんだ。
使用例:
element = driver.find_element_by_id("submit-button")
この例では、Seleniumがid="submit-button" を持つ要素を探して、それを変数elementに保存しているんだ。 フォームのボタンや入力フィールドなど、ページ上であまり重複しないユニークな要素を検索するのに便利だよ。
いつ使う?
要素にユニークなidが付いている場合は、find_element_by_id()の使用が推奨されるよ。 このメソッドは迅速かつ正確な要素へのアクセスを提供してくれる。
4. メソッド find_element_by_name()
find_element_by_name() メソッドはname属性で要素を検索するためのものだよ。 フォームや入力フィールドによく使われる。要素が同じクラスやidを持っていても、異なるnameで識別することができるんだ。 idとは異なり、name属性は必ずしもユニークである必要はないから、 同じnameを持つ複数の要素がページ上に存在する場合もあるよ。
使用例:
element = driver.find_element_by_name("username")
このコードでは、name="username" を持つ要素を検索している。通常、ログインフォームでのユーザー名入力フィールドとして使われる。
いつ使う?
ページ上で要素にユニークなidがない場合で、name属性が指定されている場合に、このメソッドは便利だよ。 特に、多くのフォーム入力ではnameで識別されることが多いからね。
5. メソッド find_element_by_class_name()
find_element_by_class_name() メソッドは、そのクラス(class)を元にして要素を検索するものだよ。 CSSのクラス名を使って、同じスタイル設定を持つ要素を探すのが簡単になる。ただし、classは複数要素に割り当てられることも多いので、 ユニークなクラスを探すか、他の方法を組み合わせて検索した方がいい場合もあるよ。
使用例:
element = driver.find_element_by_class_name("main-header")
この例では、Seleniumが最初のmain-header クラスを持つ要素を探している。
いつ使う?
find_element_by_class_name()は、ヘッダーやボタン、その他のスタイルが設定されてる要素を探すのに便利だよ。 要素にユニークなidやnameがない場合に特に役立つね。
6. 特徴とエラー
次に進む前に少し詳しく話そう。時々、ボタンや画像のような要素はユニークなidやクラスを持たないことがあるんだ。 そんな時はXPathやCSSセレクタのようなもっと高度な検索方法が役立つよ。次の講義でこれらについて話すから、心配しなくても大丈夫。
セレクタの脆弱性
idやclassといった属性を扱うときは、それらが変更される可能性があることに注意してね。 特に動的に生成されるページでは、識別子がランダムに変化することがあるんだ。解決策? より安定した属性を使うか、複合的な方法を採用しよう。
GO TO FULL VERSION