Executes the block of code passed as the second parameter, and, if it
completes abruptly with a ModifiablePayload exception,
replaces the current payload contained in the exception, if any, with the one passed
as the first parameter.
Executes the block of code passed as the second parameter, and, if it
completes abruptly with a ModifiablePayload exception,
replaces the current payload contained in the exception, if any, with the one passed
as the first parameter.
This method allows you to insert a payload into a thrown Payload exception (such as
a TestFailedException), so that payload can be included in events fired to a custom reporter
that can make use of the payload.
Here's an example in which a GUI snapshot is included as a payload when a test fails:
withPayload(generateGUISnapshot()) {
1 + 1 should be === 3
}
Trait facilitating the inclusion of a payload in a thrown ScalaTest exception.
This trait includes a
withPayloadconstruct that enables a payload object (or modified payload object) to be included as the payload of a thrown exception.Many ScalaTest events include an optional "payload" field that can be used to pass information to a custom reporter. This trait facilitates such customization, by making it easy to insert a payload into a thrown exception, such as a
TestFailedException. The thrown exception must mix inPayload. ScalaTest looks for traitPayloadand fires any payloads it finds in the relevant ScalaTest event stimulated by the exception, such as aTestFailedevent stimulated by aTestFailedException. Here's an example in which a GUI snapshot is included as a payload when a test fails:withPayload(generateGUISnapshot()) { 1 + 1 should be === 3 }