ScalaTestでカスタム失敗メッセージを表示するにはどうすればよいですか?


88

ScalaTestでカスタム失敗メッセージを表示する方法を知っている人はいますか?

例えば:

NumberOfElements() should equal (5)

失敗すると、次のメッセージが表示されます。

10は5と等しくありませんでした

しかし、私は次のようなより説明的なメッセージが必要です:

NumberOfElementsは5である必要があります。

回答:


104

あなたはそのような機能を求める最初の人です。これを実現する1つの方法は、withClueを使用することです。何かのようなもの:

withClue("NumberOfElements: ") { NumberOfElements() should be (5) }

これにより、次のエラーメッセージが表示されます。

NumberOfElements:10は5と等しくありませんでした

メッセージを完全に制御したい場合は、カスタムマッチャーを作成できます。または、次のようなアサーションを使用できます。

assert(NumberOfElements() == 5, "NumberOfElements should be 5")

ユースケースについて詳しく教えてください。10が5と等しくなかったのはなぜか、嗅ぎまわらないのはなぜですか。

これがあなたが要求している種類のものです:

scala> import org.scalatest.matchers.ShouldMatchers._
import org.scalatest.matchers.ShouldMatchers._

scala> withClue ("Hi:") { 1 + 1 should equal (3) }
org.scalatest.TestFailedException: Hi: 2 did not equal 3
at org.scalatest.matchers.Matchers$class.newTestFailedException(Matchers.scala:150)
at org.scalatest.matchers.ShouldMatchers$.newTestFailedException(ShouldMatchers.scala:2331)


scala> class AssertionHolder(f: => Any) {
     |   def withMessage(s: String) {
     |     withClue(s) { f }
     |   }
     | }
defined class AssertionHolder

scala> implicit def convertAssertion(f: => Any) = new AssertionHolder(f)
convertAssertion: (f: => Any)AssertionHolder

scala> { 1 + 1 should equal (3) } withMessage ("Ho:")
org.scalatest.TestFailedException: Ho: 2 did not equal 3
at org.scalatest.matchers.Matchers$class.newTestFailedException(Matchers.scala:150)
at org.scalatest.matchers.ShouldMatchers$.newTestFailedException(ShouldMatchers.scala:2331)

したがって、このように書くことができます:

{ NumberOfElements() should be (5) } withMessage ("NumberOfElements:")

1
it()テストに複数のアサーションを配置する必要があり、複数の整数比較がある場合があります。どのアサーションが失敗したかをログで確認してもわかりません。
Udayakumar Rayala 2011年

しかし、それを指定するwithClueの方法は読み取り可能ではありません。最後にメッセージを指定する方法はありませんか?
Udayakumar Rayala 2011年

1
最後に、マッチャーのDSLで実行することはできませんが、withClueパラメーターを逆の順序で配置するメソッドを作成できます。答えに例を追加します。
ビルベナーズ2011年

13

2011年以降の新しい方法:MatchersおよびAppendedClue1つの特性。また、コレクションサイズについては、いくつかのデフォルトメッセージがあります。

import org.scalatest.{AppendedClues, Matchers, WordSpec}

class SomeTest extends WordSpec with Matchers with AppendedClues {

  "Clues" should {
    "not be appended" when {
      "assertions pass" in {
        "hi" should equal ("hi") withClue "Greetings scala tester!"
      }
    }
    "be appended" when {
      "assertions fail"  in {
        1 + 1 should equal (3) withClue ", not even for large values of 1!"
      }
    }
    "not be needed" when {
      "looking at collection sizes" in {
        val list = List(1, 2, 3)
        list should have size 5
      }
    }
  }
}

出力は次のようになります。

SomeTest:
Clues
  should not be appended
  - when assertions pass
  should be appended
  - when assertions fail *** FAILED ***
    2 did not equal 3, not even for large values of 1! (SomeTest.scala:15)
  should not be needed
  - when looking at collection sizes *** FAILED ***
    List(1, 2, 3) had size 3 instead of expected size 5 (SomeTest.scala:21)

Listサイズメッセージは、.toString出力が長いリストには適していません。

詳細については、scaladocを参照してください。


1、私は推測しているAppendedClues特性は、この質問に触発された、受け入れ答えのビル・ベナーズは、この形質の著者です。


2

withClue何もインポートしたり、テストクラスに追加したりせずに使用することもできます。

withClue(s"Expecting distinct elements: ${elements.toList}") { elements.length shouldBe 3 }

これはAssertionsクラスからインポートされます:org.scalatest.Assertions#withClue


これは、受け入れられた答えに加えて何を追加しますか?
チルダ
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.