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

【Ruby】window_handles・・・複数のウインドウハンドルを取得する

「window_handles」実行で複数のウインドウハンドルを取得できます。

カレントウインドウ(制御対象になっているウインドウ)のハンドルのみを取得する「current_window_handle」と異なり「window_handles」はカレントセッション(指定したインスタンス)の全てのハンドルを取得していきます。そして複数取得したウインドウハンドルをswitch_to.window(xxx)で指定することで制御したいウインドウ(ブラウザ)を切り替えることが出来ます。

「window_handles」のウインドウハンドル取得順序ですが、最初にインスタンスウインドウ(一番初めに開いたウィンドウ)のウインドウハンドルを取得し、それ以降は最も新しい(最後に開いた)ウインドウからウインドウハンドルを取得していきます。

下記サンプルでは、まず初めにインスタンスウインドウとなるgetWindowHandles.html<図1>を開いています。次に開いたインスタンスウインドウから各サイトへ複数の新規ウインドウ開いています。そしてそれぞれのウインドウハンドルを取得し、ウインドウハンドルをswitch_to.window(xxx)で指定することで個別のウインドウ制御を可能にしています。

説明

◆メソッド
  ・window_handles
◆使用形態
  ・driver.window_handles
◆備考
  ・window_handles実行でまず初めにインスタンスウインドウのウインドウハンドル
   を取得し、それ以降は新しいウインドウからウインドウハンドルを取得していく
◆関連項目
  ・
  ・

サンプル

require 'selenium-webdriver'

# Firefoxを起動
driver = Selenium::WebDriver.for(:firefox)
#指定したURLに遷移<図1>
driver.get('file://D:/AutoTest/getWindowHandles.html')
#それぞれのテキスト名のリンク要素を取得
link1 = driver.find_element(:partial_link_text, 'Yahoo Top')
link2 = driver.find_element(:partial_link_text, 'Firefox Top')
link3 = driver.find_element(:partial_link_text, 'Opera Top')
#ローカルファイル内のYahooへのリンクをクリックし新規ウィンドウを立ち上げる
link1.click
#ローカルファイル内のFirefoxへのリンクをクリックし新規ウィンドウを立ち上げる
link2.click
#ローカルファイル内のOperaへのリンクをクリックし新規ウィンドウを立ち上げる
link3.click
#全てのウィンドウハンドルを取得
allHandles = driver.window_handles
#ウィンドウハンドル1
puts(allHandles[0])
#ウィンドウハンドル2
puts(allHandles[1])
#ウィンドウハンドル3
puts(allHandles[2])
#ウィンドウハンドル4
puts(allHandles[3])
#getWindowHandles.htmlの内容からMSNページへ移行した
driver.switch_to.window(allHandles[0])
driver.get('http://www.msn.com')
#OperaページからGoogleページへ移行した
driver.switch_to.window(allHandles[1])
driver.get('https://www.google.com')
#FirefoxページからMicrosoftページへ移行した
driver.switch_to.window(allHandles[2])
driver.get('https://www.microsoft.com')

実行結果

1234593452
1234534689
1234534557
1234534555
※ここで設定されているウインドウハンドルの内容は架空の値です

getWindowHandles.html<図1>

<!DOCTYPE html>
<html lang="ja">
    <head>
        <meta charset="UTF-8">
        <title>SeleniumTest</title>
    </head>
    <body>
        <div>
            <a href="http://www.yahoo.co.jp/" target="YAHOO">Yahoo Top</a>
        </div>
        <div>
            <a href="https://www.firefox.com/" target="FIREFOX">Firefox Top</a>
        </div>
        <div>
            <a href="http://www.opera.com/ja" target="OPERA">Opera Top</a>
        </div>
    </body>
</html>

動画デモ

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

カテゴリー

Selenium導入

APIリファレンス

その他

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