1. フォーム要素との対話の入門
ウェブページ上のフォームは、インタラクションの魔法が始まる場所だよ。 フォームを秘密のコントロールパネルと考えてみて、それを使ってユーザーがシステムとやりとりできるんだ。 でも、ロボット掃除機に指示を出すのではなく、サイトに情報を提供する感じかな。
テキストフィールドにテキストを入力する方法
まず最初に、Seleniumを使ってテキストフィールドにテキストを入力するやり方について話そう。 これはsend_keys()メソッドを使ってやるよ。段階を追って見ていこう。
重要: 以下の例は Selenium 3 の書き方です。Selenium 4 では find_element_by_* メソッドは削除され(4.3.0 以降は完全に)、代わりに By クラスの指定を受け取る汎用の find_element() を使います。そのため、各例のあとに Selenium 4 版を載せています。
重要: executable_path 引数は Selenium 4.10 でドライバのコンストラクタから削除されました。ドライバのパスは Service オブジェクトで渡します。
from selenium import webdriver
# WebDriverのパスを指定、ここは自分のwebdriverコピーのパスだよ
driver = webdriver.Chrome(executable_path='path/to/chromedriver')
# ウェブページを開く
driver.get('http://example.com/login')
# 入力フィールドを見つけて(例えばidで)テキストを入力
username_field = driver.find_element_by_id('username')
username_field.send_keys('moya_super_uchyotnaya_zapiska')
password_field = driver.find_element_by_id('password')
password_field.send_keys('moy_super_sekretnyy_parol')
同じ内容を Selenium 4 で書くと:
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.chrome.service import Service
# WebDriverのパスを指定、ここは自分のwebdriverコピーのパスだよ
service = Service('path/to/chromedriver')
driver = webdriver.Chrome(service=service)
# ウェブページを開く
driver.get('http://example.com/login')
# 入力フィールドを見つけて(例えばidで)テキストを入力
username_field = driver.find_element(By.ID, 'username')
username_field.send_keys('moya_super_uchyotnaya_zapiska')
password_field = driver.find_element(By.ID, 'password')
password_field.send_keys('moy_super_sekretnyy_parol')
この簡単な例では、ページを開いて、IDで入力要素を見つける。 次にsend_keys()メソッドを使ってフィールドにテキストを渡すんだ。 コピー&ペーストが次のレベルに進化した感じだよ!
テキストフィールドを埋めるための重要なトリック
フォームが変な動きをすると思ったら、入力フィールドに既にテキストが入っている可能性がある。 新しいテキストを入力する前に、clear()メソッドを使って古いものを消そう。
username_field.clear()
username_field.send_keys('atarashii_chi')
この小さなトリックは、余計な頭痛から救ってくれるよ、本当に!
2. ボタンをクリックする
入力フィールドが埋まったら次はボタンだね。 例えばフォームを送信するために。Seleniumではclick()メソッドを使うよ。 「もっとミームを見る」ボタンを押すのと同じ感じで、でもコードで。
# ボタンを名前で見つけてクリック
login_button = driver.find_element_by_name('login')
login_button.click()
同じ内容を Selenium 4 で書くと:
# ボタンを名前で見つけてクリック
login_button = driver.find_element(By.NAME, 'login')
login_button.click()
こうして、Seleniumスクリプトはクリックのマスターになって、 ゲームで「選択を決定する」ボタンを押す以上のことができるんだ!
使用例
登録フォームを埋めて送信するためにsend_keys()とclick()メソッドをどう使うか、一緒に見てみよう。
# 登録ページを開く
driver.get('http://example.com/register')
# 登録フォームを埋める
driver.find_element_by_id('first_name').send_keys('イワン')
driver.find_element_by_id('last_name').send_keys('イワノフ')
driver.find_element_by_id('email').send_keys('ivan@example.com')
driver.find_element_by_id('password').send_keys('superSekuretto123')
# 「登録」ボタンをクリック
register_button = driver.find_element_by_css_selector('.register-button')
register_button.click()
同じ内容を Selenium 4 で書くと:
# 登録ページを開く
driver.get('http://example.com/register')
# 登録フォームを埋める
driver.find_element(By.ID, 'first_name').send_keys('イワン')
driver.find_element(By.ID, 'last_name').send_keys('イワノフ')
driver.find_element(By.ID, 'email').send_keys('ivan@example.com')
driver.find_element(By.ID, 'password').send_keys('superSekuretto123')
# 「登録」ボタンをクリック
register_button = driver.find_element(By.CSS_SELECTOR, '.register-button')
register_button.click()
このシンプルな例は、登録フォームをテストしたり、 ユーザーのアクティビティをシミュレーションするのに便利だよ。
3. 気まぐれなフォームへの対処
ページはときどき、君にいたずらを仕掛けてくる。ボタンを押しても何も起きない。もっとひどいと、ページがエラーを返す。 よくある問題と、その対処法をいくつか見ていこう。
動的な要素を扱う
ページ上の要素は、すぐに読み込まれるとは限らない。そういうとき、スクリプトは要素が読み込まれる前に操作しようとしてしまう。 卵を冷蔵庫から出す前にオムレツを作りはじめるようなものだね。
この気まぐれを避けるには、待機を使おう。Seleniumでは、要素が使えるようになるまで待つことができる:
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
# 要素がクリックできる状態になるまで待ってから、クリックする
register_button = WebDriverWait(driver, 10).until(
EC.element_to_be_clickable((By.CSS_SELECTOR, '.register-button'))
)
register_button.click()
WebDriverWaitを使えば、要素が操作できる状態になるまで待つようSeleniumに指示できる。 これだけでスクリプトの安定性はぐっと上がるよ。
見えない要素を操作する
ページ上の要素の中には、見えないものもある——たとえば隠されたボタンや入力欄だ。そのまま操作しようとするとエラーになることがある。 そんなときはJavaScriptで要素を表示させてしまえばいい:
driver.execute_script("arguments[0].style.visibility='visible';", hidden_element)
hidden_element.click()
この方法なら、何らかの理由で隠れている要素とも やり取りできる。
4. 実践的な応用: フォームの自動化
フォームの操作の仕方が分かったところで、これが現実のどんな場面で役に立つか想像してみよう。
上司が「全員、日報はWebフォームから出すこと」と決めたとする。もちろん君は、この繰り返し作業を少しでも自動化したい。 Seleniumを使えば、毎日フォームに日報のデータを自動で入力して送信するスクリプトを作れるんだ。
日報の自動化の例
日報用のフォームがあるサイトを想像してみて。フォームには名前、部署、そして終わった仕事の報告を書く欄がある。これを自動化しよう:
driver.get('http://example.com/daily_report')
# 日報フォームを埋める
driver.find_element_by_id('name').send_keys('佐藤 花子')
driver.find_element_by_id('department').send_keys('技術部')
driver.find_element_by_id('report').send_keys('今日はバグを全部直しました!')
# フォームを送信する
submit_button = driver.find_element_by_id('submit')
submit_button.click()
同じ内容を Selenium 4 で書くと:
driver.get('http://example.com/daily_report')
# 日報フォームを埋める
driver.find_element(By.ID, 'name').send_keys('佐藤 花子')
driver.find_element(By.ID, 'department').send_keys('技術部')
driver.find_element(By.ID, 'report').send_keys('今日はバグを全部直しました!')
# フォームを送信する
submit_button = driver.find_element(By.ID, 'submit')
submit_button.click()
こういうスクリプトは貴重な時間を節約してくれるし、人為的なミスの余地もなくしてくれる。 ただし複雑なフォームでは、一つひとつの手順をテストして、起こりうるエラーも考えておく必要があるよ。
さて、今日の講義はここまで! 今回は入力欄にテキストを入れ、オンラインアンケートのようにボタンを押す方法を学んだ。 これで、Webページとのやり取りを自動化するとんでもない力が手に入ったわけだ。
Seleniumでの実験を続けよう。ブラウザを本物の自動化マシンに変える方法を、これからもっと紹介していくからね!
GO TO FULL VERSION