Verify メソッド

クラス

Workbench

処理

予想した値と実際の値が等しいかどうかを検証します。コメントを指定することもできます。

構文

このメソッドには多くのオーバーロードがあります。
result = Workbench.Verify(condition[, VerifyFlags])
または
result = Workbench.Verify(condition[, comment, VerifyFlags])
または
result = Workbench.Verify(expected, actual[, VerifyFlags])
または
result = Workbench.Verify(expected, actual[, VerifyFlags, comment])
変数 説明
result 検証が成功したかどうか。BOOLEAN
condition 満たす必要がある条件。BOOLEAN
expected スクリプトから返されると予測される値。OBJECT
actual スクリプトから実際に返される値。OBJECT
comment 省略可能:追加するコメント。STRING
VerifyFlags 省略可能:検証の失敗時にスクリーンショットをキャプチャするかどうか。この列挙には、次の値を指定できます。
  • None
  • ScreenShotOnFailure
VerifyFlags

使用例

期待値と実際の値を比較して、コメントを追加するには、以下のように入力します。
Workbench.Verify(expected As Object, actual As Object, comment As String)

たとえば、Workbench.Verify("red", "green", "checking colors") は検証に失敗し、メッセージ「checking colors - 実際:[green]; 予想: [red]」が表示されます。

期待値と実際の値を比較して、コメントを追加し、さらに検証が失敗した場合にスクリーンショットを結果ファイルに追加するには、以下のように入力します。
Workbench.Verify(expected As Object, actual As Object, comment As String, verifyFlags As VerifyFlags)

たとえば、Workbench.Verify("red", "green", "checking colors", verifyFlags.ScreenShotOnFailure) は検証に失敗し、メッセージ「checking colors - 実際:[green]; 予想: [red]」が表示され、スクリーンショットが結果ファイルに追加されます。

予想結果によって返された値を検証して、コメントを追加するには、以下のように入力します。
Workbench.Verify(condition As Boolean, comment As String)

たとえば、Workbench.Verify(True, "Test Passed") は検証に合格します。一方、Workbench.Verify(False, "Test Failed") は検証に失敗します。

予想結果によって返された値を検証して、コメントを追加し、さらに検証が失敗した場合にスクリーンショットを結果ファイルに追加するには、以下のように入力します。
Workbench.Verify(condition As Boolean, comment As String, verifyFlags As VerifyFlags)

たとえば、Workbench.Verify(True, "Test Passed", verifyFlags.ScreenShotOnFailure) は検証に合格し、スクリーンショットは追加されません。一方、Workbench.Verify(False, "Test Failed", ScreenShotOnFailure) は検証に失敗し、スクリーンショットが結果ファイルに追加されます。

IEnumerable オブジェクト(リストや配列など)について実際の値と期待値を比較するには、以下のように入力します。
Workbench.Verify(expectedEnumerable, actualEnumerable) 
例:
Dim selectedItemsList = listBox.SelectedItems ' we assume that a list with the items "red" and "blue" is returned
Dim expectedItemsList = New List(Of String)()
expectedItemsList.Add("red")
expectedItemsList.Add("blue")

Workbench.Verify(selectedItemsList, expectedItemsList)  ' verification passes

Dim expectedItemsArray = New String() { "red", "blue" }
Workbench.Verify(selectedItemsList, expectedItemsArray) ' verification passes
注: 2 つの IEnumerable オブジェクトは、要素の数が同じであり、それらの要素が等しく、かつ順序が同じである場合に、等しいとみなされます。
注: 浮動小数点数を含む数学演算では、2 つの数値が、ユーザーの視点では等しいにもかかわらず、内部表現のために完全には同一ではないとみなされる場合があります。このため、浮動小数点数(単精度、倍精度)は、差異が 0.00001 未満である場合は等しいとみなされます。この値は、状況によっては正しくない場合があります。その場合は、代わりに Verify(result As Boolean) を使用して 2 つの値を比較します。