トップページ > Selenium API(逆引き) > 【Ruby】wait/until/selected?

【Ruby】wait/until/selected?・・・要素がチェックON/チェックOFFになるまで待機する

「wait/until/selected?」を実行することで要素がチェックONまたはチェックOFFの、期待された状態になるまで待機することが出来ます。

下記サンプルではまず初めに、「Wait」コンストラクタの引数に(※1)オプション(ここでは:timeout)と待ち時間(秒数)を指定して、インスタンスを作成しています。

次に作成されたインスタンスに対して「until」メソッドを実行しています。「until」メソッドは、引数に指定された条件が「真」になるまで待機するメソッドです。下記サンプルではfind_elementでid属性から要素を取得し、その要素がチェック状態(選択状態)であるかどうかを確認しています。つまり総合すると、要素がチェック状態になるまで待つという処理をしています。もし要素が「wait」コンストラクタで指定した待ち時間を越えても、チェック状態にならない場合はerrorが発生します。

ここで「until」メソッドの引数に指定された条件が「偽」になるまで待機するという意味合いを持たせるには、中括弧の直後に感嘆符「!」を入れる必要があります。
until{!find_element(:id, 'ra01').selected?}

(※1)オプションは「:timeout」、「:interval」、「:message」、「:ignore」の4種類あります。「:interval」はポーリング間隔で、値には秒数を指定します。「:message」はタイムアウトが発生した場合に出力するException mesageを指定します。「:ignore」はポーリングしているときにどのExceptionを無視するか指定します。また、複数のオプションを利用する場合は以下のようにカンマで区切ります。
Wait.new(:timeout => 3, :message => "Test Failed")

説明

◆メソッド
  ・Wait.new(:timeout => xxx)   :Waitコンストラクタにオプションと秒数を指定
  ・wait.until {true}            :中括弧内の条件が「真」になるまで待機する
  ・element.selected?         :指定した要素がチェック状態か確認
◆使用形態
  ・wait.until {driver.find_element(:id, 'abc').selected?}
◆備考
  ・チェックボックスやラジオボタンなどのSelection Controlsに対して有効
  ・最大待機時間を越えても要素が指定された選択状態になっていない場合errorが発生する
◆関連項目
  ・
  ・

サンプル

require 'selenium-webdriver'

# Firefoxを起動
driver = Selenium::WebDriver.for(:firefox)
#指定したURLに遷移する<図1>
driver.get('file://D:/AutoTest/isSelected.html')
#指定したdriverに対して最大で10秒間待つように設定する
wait = Selenium::WebDriver::Wait.new(:timeout => 10)
#「はい」ラジオボタンの要素を取得しチェック状態になるまで待機する(最大で10秒間待つ)
wait.until {driver.find_element(:id, 'ra01').selected?}

実行結果

wait/until/selected?

isSelected.html<図1>

<!DOCTYPE html>
<html lang="ja">
    <head>
        <title>isSelected</title>
    </head>
    <body>
        <p>
            Seleniumで自動テストを実施したいですか? 
        </p>
        <p>
            <input type="radio" id="ra01" name="question" checked>はい<br>
            <input type="radio" id="ra02" name="question">いいえ<br>
            <input type="radio" id="ra03" name="question">どちらとも言えない
        </p>
    </body>
</html>

カテゴリー

Selenium導入

APIリファレンス

その他

ページ上部へ戻る
トップページ > Selenium API(逆引き) > 【Ruby】wait/until/selected?
Copyright © 2016- Seleniumクイックリファレンス All Rights Reserved