Failure (JUnit API)

java.lang.Object
- org.junit.runner.notification.Failure

All Implemented Interfaces:

java.io.Serializable
```
public class Failure
extends java.lang.Object
implements java.io.Serializable
```
A Failure holds a description of the failed test and the exception that was thrown while running it. In most cases the Description will be of a single test. However, if problems are encountered while constructing the test (for example, if a BeforeClass method is not static), it may describe something other than a single test.

Since:

4.0

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor Description

Failure(Description description, java.lang.Throwable thrownException)
Constructs a Failure with the given description and exception.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`Description`	`getDescription()`
`java.lang.Throwable`	`getException()`
`java.lang.String`	`getMessage()`	Convenience method
`java.lang.String`	`getTestHeader()`
`java.lang.String`	`getTrace()`	Gets the printed form of the exception and its stack trace.
`java.lang.String`	`getTrimmedTrace()`	Gets a the printed form of the exception, with a trimmed version of the stack trace.
`java.lang.String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Failure
```
public Failure(Description description,
               java.lang.Throwable thrownException)
```
    Constructs a Failure with the given description and exception.
    
    Parameters:
    
    description - a Description of the test that failed
    
    thrownException - the exception that was thrown while running the test
- Method Detail
  - getTestHeader
```
public java.lang.String getTestHeader()
```
    Returns:
    
    a user-understandable label for the test
  - getDescription
```
public Description getDescription()
```
    Returns:
    
    the raw description of the context of the failure.
  - getException
```
public java.lang.Throwable getException()
```
    Returns:
    
    the exception thrown
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - getTrace
```
public java.lang.String getTrace()
```
    Gets the printed form of the exception and its stack trace.
  - getTrimmedTrace
```
public java.lang.String getTrimmedTrace()
```
    Gets a the printed form of the exception, with a trimmed version of the stack trace. This method will attempt to filter out frames of the stack trace that are below the test method call.
  - getMessage
```
public java.lang.String getMessage()
```
    Convenience method
    
    Returns:
    
    the message of the thrown exception