trait Checkpoints extends AnyRef
Trait providing class Checkpoint, which enables multiple assertions
to be performed within a test, with any failures accumulated and reported
together at the end of the test.
Because ScalaTest uses exceptions to signal failed assertions, normally execution
of a test will stop as soon as the first failed assertion is encountered. Trait
Checkpoints provides an option when you want to continue executing
the remainder of the test body, or part of it, even if an assertion has already failed in that test.
To use a Checkpoint (once you've mixed in or imported the members of trait
Checkpoints), you first need to create one, like this:
val cp = new Checkpoint
Then give the Checkpoint assertions to execute by passing them (via a by-name parameter)
to its apply method, like this:
val (x, y) = (1, 2)
cp { x should be < 0 }
cp { y should be > 9 }
Both of the above assertions will fail, but it won't be reported yet. The Checkpoint will execute them
right away, each time its apply method is invoked. But it will catch the TestFailedExceptions and
save them, only reporting them later when reportAll is invoked. Thus, at the end of the test, you must call
reportAll, like this:
cp.reportAll()
This reportAll invocation will complete abruptly with a TestFailedException whose message
includes the message, source file, and line number of each of the checkpointed assertions that previously failed. For example:
1 was not less than 0 (in Checkpoint) at ExampleSpec.scala:12 2 was not greater than 9 (in Checkpoint) at ExampleSpec.scala:13
Make sure you invoke reportAll before the test completes, otherwise any failures that were detected by the
Checkpoint will not be reported.
Note that a Checkpoint will catch and record for later reporting (via reportAll) exceptions that mix in StackDepth
except for TestCanceledException, TestRegistrationClosedException, NotAllowedException,
and DuplicateTestNameException. If a block of code passed to a Checkpoint's apply method completes
abruptly with any of the StackDepth exceptions in the previous list, or any non-StackDepth exception, that invocation
of the apply method will complete abruptly with the same exception immediately. Unless you put reportAll in a finally
clause and handle this case, such an unexpected exception will cause you to lose any information about assertions that failed earlier in the test and were
recorded by the Checkpoint.
- Source
- Checkpoints.scala
- Alphabetic
- By Inheritance
- Checkpoints
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Type Members
- class Checkpoint extends AnyRef
Class that allows multiple assertions to be performed within a test, with any failures accumulated and reported together at the end of the test.
Class that allows multiple assertions to be performed within a test, with any failures accumulated and reported together at the end of the test.
See the main documentation for trait
Checkpointsfor more information and an example.
Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##: Int
- Definition Classes
- AnyRef → Any
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @native()
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef → Any
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable])
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- def hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
- def toString(): String
- Definition Classes
- AnyRef → Any
- final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()