トップページ > Selenium API(逆引き) > 【Java】elementSelectionStateToBe

【Java】elementSelectionStateToBe・・・要素がチェックON/チェックOFFになるまで待機する

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

下記サンプルではまず初めに、ON/OFF状態を確認したいチェックボックスの要素を取得した後、「WebDriverWait」コンストラクタの引数に対象driverと待ち時間(秒数)を指定して、インスタンスを作成しています。

次に作成されたインスタンスに対して「until」メソッドを実行しています。「until」メソッドは、引数に指定された条件が真になるまで待機するメソッドです。引数に指定するメソッドの「elementSelectionStateToBe」は、「ExpectedConditions.elementSelectionStateToBe」の形で用いることで要素の選択状態を確認することができます。また、「elementSelectionStateToBe」は引数を設定する必要があります。第1引数で選択状態を確認したい要素を指定し、第2引数でチェックONを期待値とするかチェックOFFを期待値にするかを設定していきます。つまり総合すると要素が期待されたチェック状態になるまで待つということになります。もし要素が「WebDriverWait」コンストラクタで指定した待ち時間を越えても、期待値の状態にならない場合はExceptionが発生します。

※条件を指定して待機についてはこちら

説明

◆メソッド
  ・public static ExpectedCondition<java.lang.Boolean>  
                      elementSelectionStateToBe(WebElement element,boolean selected)

◆使用形態
  ・ExpectedConditions.elementSelectionStateToBe(element,selected)
◆備考
  ・チェックボックスやラジオボタンなどのSelection Controlsに対して実行される
  ・最大待機時間を越えても要素が指定された選択状態になっていない場合Exceptionが発生する
◆関連項目
  ・要素がクリック出来る状態になるまで待機する
  ・指定した要素が表示されるまで待機する

サンプル

public class WebTest{
  public static void main(String[] args){
	//Chrome制御のためChromeDriverサーバーのパスを指定
	System.setProperty("webdriver.chrome.driver",
			                            "D:\\AutoTest\\chromedriver.exe");
	//Chromeを起動する
	WebDriver driver = new ChromeDriver();
	try{
      //指定したURLに遷移する<図1>
      driver.get("file://D:/AutoTest/elementSelectionStateToBe.html");
      //チェックボックスの要素を取得する
      WebElement element = driver.findElement(By.id("ch02"));
      //要素がチェックOFF状態を期待値とする
      boolean selected = false;
	  //指定したdriverに対して最大で10秒間待つように設定する
	  WebDriverWait wait = new WebDriverWait(driver, 10);
      //指定した要素が期待値と同じ選択状態になるまで待機する
      boolean result = wait.until(ExpectedConditions.
                               elementSelectionStateToBe(element,selected));
      //期待値とチェック状態が同じならばtrueを表示
      System.out.println(result);
	}catch(Exception e){
      e.printStackTrace();
	}
  }
}

実行結果

true
elementSelectionStateToBe

elementSelectionStateToBe.html<図1>

<!DOCTYPE html>
<html lang="ja">
    <head>
        <title>elementSelectionStateToBe</title>
    </head>
    <body>
        <p>
            Seleniumで自動テストを実施する目的を全て教えて下さい。 
        </p>
        <p>
            <input type="checkbox" id="ch01" name="question" checked>便利だから
            <input type="checkbox" id="ch02" name="question">上司から言われたから
            <input type="checkbox" id="ch03" name="question">たまたまWebでみつけたから
            <input type="checkbox" id="ch04" name="question" checked>その他
        </p>
    </body>
</html>

動画デモ

※字幕をONにすると解説のテロップが表示されます※

カテゴリー

Selenium導入

APIリファレンス

その他

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