WebElementの検出

Selenium WebDriver接続に基づき、テスト用のSenseTalkスクリプトを記述する際に、テスト対象ページのドキュメントオブジェクトモデル（DOM）内の様々なHTML要素とのやり取りに関して、労力の多くが割かれる傾向があります。 DOMにおけるこれらの要素は、しばしばWebElementオブジェクトと呼ばれます。

SenseTalkでは、ページ内のWebElementを様々な方法で特定するための複数のコマンドと関数を用意しており、これらを利用してアクリョンを実行したり、情報を検出したり、このような要素に対して検証を行ったりすることができます。 下記に、以下のコマンドと関数の説明を示します。

• FindElement()、FindElements()関数
• WebElementFound()関数
• WaitForコマンド
• FoundWebElement()関数
• FoundWebLocation()関数

WebElement識別子

WebDriver接続でFindElement()関数やClickコマンドを使用する場合など、DOM内のWebElementにアクセスする場合は、やり取りしたい要素を特定するのに複数の方法を利用できます。 DOM内の要素を特定するのに、以下のWebElement識別子を利用できます。

• webID：本プロパティを利用して、そのID属性の値によって要素を特定できます。
• webName：本プロパティを利用して、その名前属性の値によって要素を特定できます。
• webTagName：本プロパティを利用して、そのHTMLタグが所定の値と等しい要素を特定できます。
• webClassName：本プロパティを利用して、そのクラス属性の値によって要素を特定できます。
• webLinkText：本プロパティを利用して、そのテキストが指定された値と等しいリンクを特定できます。
• webPartialLinkText：本プロパティを利用して、そのテキストが指定された値を含むリンクを特定できます。
• webCssSelector：本プロパティを利用して、指定されたCSSセレクタ式を使用している要素を特定できます。
• webXPath：本プロパティを利用して、XPath式によって要素を特定できます。 XPathとXPath式に関する詳細は、Selenium WebDriverにおけるXPath：完全な手引きを参照してください。

WebElementオブジェクト

正常なWebElement検索によってWebElementオブジェクトが作成されます。 本オブジェクトには、検出された要素に関する情報を含むプロパティリストが含まれます。 WebElementオブジェクトには、以下のリストの任意のプロパティを含めることができますが、すべてのプロパティが必ず値を返すわけではありません。 どのプロパティが役に立つ値を持っているかは、特定のWebElementの種類によって決定されます。

• Text：ブラウザ内に表示される要素に含まれる可視化されたテキスト。
• tagName：要素のHTMLタグ名。
• Name：要素の名前属性の値。
• ID：要素のID属性の値。
• Class：要素のクラス属性の値。
• Attribute()：要素の特定の属性の値を返します（属性が存在しない場合はemptyとなります）。
• isSelected：TrueまたはFalseを返し、要素がブラウザ内で選択されているかどうかを示します。
• isEnabled：TrueまたはFalseを返し、要素がブラウザ内で有効かどうかを示します。
• isDisplayed：TrueまたはFalseを返し、要素がブラウザ内で表示されているかどうかを示します。
• Origin：ページ内における要素の起点（左上隅）のwebLocationプロパティリストを返します。 例：
  (objectType:"webLocation", x:"262", y:"323")
• Size：ページ内の要素のサイズ（幅、高さ）を返します。
• Rectangle：ページ内の要素の矩形(x1, y1, x2, y2)を返します。 これらはブラウザの座標であり、画面の座標ではないことに注意してください。
• cssProperty：要素の指定されたCSSプロパティの値を返します。
• WebDriver：要素を含むWebDriver接続に関するWebDriverConnectionオブジェクトを返します。
• WebContext：要素を含むWebDriver接続に関するWebDriverConnectionオブジェクトか、内部で所定の要素が検出されたWebElementオブジェクトのいずれかを返します。

FindElement、FindElementsコマンドおよび関数

挙動：FindElementは、コマンドと関数のいずれかとして呼び出すことができます。 本コマンドまたは関数は、ページ内または別の要素内の特定の要素を特定します。 FindElementは、以前のFindElementプロパティ またはActiveElementプロパティ の呼び出しによって返された、WebDriverConnectionオブジェクト上またはWebElemenオブジェクト上のいずれかで呼び出すことができます。

FindElementsは、コマンドまたは関数としてFindElementと全く同じように機能しますが、最初にマッチングした要素を返す代わりに、検出されたすべてのマッチング要素を含むリストを返します。

パラメータ：オプションのWebDriverConnectionオブジェクトと必須のWebElement識別子を含むプロパティリスト。 WebDriverConnectionを指定しない場合は、アクティブな接続が使用されます。

構文：

戻り値：返される値は、FindElementについてはWebElementオブジェクト、FindElementsについてはWebElementオブジェクトのリストとなります。

例：

例：

例：

例：

例：

例：

例：

例：

例：

例：

例：

例：

WebElementFound()関数

挙動：DOMにおいて、所定のWebElementを検索します。 本関数は、WebElementが検出された場合はtrueを返し、検出されない場合はfalseを返します。

パラメータ：必須のWebElement識別子と、WebElementが表示されるまでの待ち時間を設定するオプションのWaitForプロパティを含むプロパティリスト。

構文：

例：

例：

例：

例：

例：

WaitForコマンド

挙動：DOM内でWebElementが検出されるまで、スクリプトの次の行の実行を一時停止します。 指定された待ち時間内にWebElementが検出されなければ、例外が投げられます。

パラメータ：待ち時間と1つ以上のWebElement識別子。 待ち時間は、デフォルトでは秒単位です。

構文：

例：

例：

例：

例：

FoundWebElement()関数

挙動：本関数は、最後に検出されたWebElementに関する情報を提供します。

パラメータ：なし（一番最後に検出されたWebElementを参照します）。

構文：

戻り値：検出されたWebElementに関する情報のプロパティリストを含むWebElementオブジェクト。 すべてのタイプのWebElementが、各WebElementオブジェクトプロパティの値を返すわけではないことに注意してください。

例：

例：

例：

例：

例：

例：

例：

FoundWebLocation()関数

挙動：本関数は、ブラウザ内のWebElementの場所に関する情報を返します。

パラメータ：なし（一番最後に検出されたWebElementを参照します）。

構文：

戻り値：objectType、xおよびyプロパティを含むwebLocationのプロパティリスト。 objectTypeは常にwebLocationであり、xおよびyプロパティは、WebElementが検出されたウェブページ上の点の座標を表します。 例：

例：

例：

例：

例：

例：

 

This topic was last updated on 2月 01, 2019, at 11:13:23 午前.

Eggplant.io | Documentation Home | User Forums | Support | Copyright © 2019 Eggplant