コーディングによるスクリプトへの検証の追加

スクリプトの結果が予想された結果と一致するかどうかを判断するために、検証を挿入します。

  1. 検証を組み込むスクリプトを開きます。
  2. 以下の検証メソッドのいずれかを挿入します。
    • 期待値と実際の値を比較するには、以下のように入力します。
      Workbench.Verify(expected As Object, actual As Object)

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

    • 期待値と実際の値を比較して、コメントを追加するには、以下のように入力します。
      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)

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

    • 予想結果によって返された値を検証して、コメントを追加するには、以下のように入力します。
      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 つの値を比較します。