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

【Java】frameToBeAvailableAndSwitchToIt・・・指定したフレームが利用できる状態になるまで待機する

「frameToBeAvailableAndSwitchToIt」を実行することで指定したフレームが利用できる状態になるまで待機することが出来ます。

下記サンプルではまず初めに、「WebDriverWait」コンストラクタの引数に対象driverと待ち時間(秒数)を指定して、インスタンスを作成しています。

次に作成されたインスタンスに対して「until」メソッドを実行しています。「until」メソッドは、引数に指定された条件が真になるまで待機するメソッドです。引数に指定するメソッドの「frameToBeAvailableAndSwitchToIt」は、「ExpectedConditions.frameToBeAvailableAndSwitchToIt」の形で用いることでフレームを切り替えることが出来ます。また、「frameToBeAvailableAndSwitchToIt」は引数にフレーム参照番号を設定する必要があり、参照番号によってフレームを指定していきます(フレーム参照番号はフレームそれぞれに設定される番号で、<frameset>内に定義された順番に0から割り当てられます)。つまり総合すると、取得したフレームに切り替えて利用出来るまで待つということになります。もしフレームが「WebDriverWait」コンストラクタで指定した待ち時間を越えても、期待値の状態にならない場合はexceptionが発生します。

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

説明

◆メソッド
  ・public static ExpectedCondition<WebDriver> 
              frameToBeAvailableAndSwitchToIt(int frameLocator)

◆使用形態
  ・ExpectedConditions.frameToBeAvailableAndSwitchToIt(frameLocator)
◆備考
  ・引数で指定した(フレーム参照番号の)フレームが利用できるまで待機する
  ・最大待機時間を越えてもフレームが利用出来る状態にならない(選択したフレームが存在しない)
   場合はExceptionが発生する
◆関連項目
  ・Alertが表示されるまで待機する
  ・要素がチェックONまたはチェックOFFになるまで待機する

サンプル

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/frameToBeAvailable_main.html");
	  //指定したdriverに対して最大で10秒間待つように設定する
	  WebDriverWait wait = new WebDriverWait(driver, 10);
      //フレームの参照番号(0から始まる)でフレームを選択する
      int frameLocator = 0;
      //指定されたフレームが利用出来るまで待機する
      WebDriver frame = wait.until(ExpectedConditions.
                  frameToBeAvailableAndSwitchToIt(frameLocator));
      //取得したフレームのソースを表示
      System.out.println(frame.getPageSource());
	}catch(Exception e){
      e.printStackTrace();
	}
  }
}

実行結果

<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" lang="ja"><head></head><body bgcolor="red" text="#ffffff">
        <b>フレーム1</b>
    
</body></html>
frameToBeAvailableAndSwitchToIt

frameToBeAvailable_main.html<図1>

<!DOCTYPE html>
<html lang="ja">
    <head>
        <title>frameToBeAvailable_main</title>
    </head>
    <frameset cols="30%, 70%">
        <frameset rows="180, *">
            <frame src="frameToBeAvailable_1.html">
            <frame src="frameToBeAvailable_2.html">
        </frameset>
        <frame src="frameToBeAvailable_3.html">
    </frameset>
</html>

frameToBeAvailable_1.html(フレーム1)

<!DOCTYPE html>
<html lang="ja">
    <body bgcolor="red" text="#ffffff">
        <b>フレーム1</b>
    </body>
</html>

frameToBeAvailable_2.html(フレーム2)

<!DOCTYPE html>
<html lang="ja">
    <body bgcolor="olive"  text="#ffffff">
        <b>フレーム2</b>
    </body>
</html>

frameToBeAvailable_3.html(フレーム3)

<!DOCTYPE html>
<html lang="ja">
    <body bgcolor="aqua"  text="#ffffff">
        <b>フレーム3</b>
    </body>
</html>

カテゴリー

Selenium導入

APIリファレンス

その他

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