ThrowableSubject (Truth HEAD-SNAPSHOT)

java.lang.Object
- com.google.common.truth.Subject
- - com.google.common.truth.ThrowableSubject

Direct Known Subclasses:

TruthFailureSubject
```
public class ThrowableSubject
extends Subject
```
A subject for Throwable values.
Truth does not provide its own support for calling a method and automatically catching an expected exception, only for asserting on the exception after it has been caught. To catch the exception, we suggest assertThrows (JUnit), assertFailsWith (kotlin.test), or similar functionality from your testing library of choice.
```
 InvocationTargetException expected =
     assertThrows(InvocationTargetException.class, () -> method.invoke(null));
 assertThat(expected).hasCauseThat().isInstanceOf(IOException.class);
 
```

Nested Class Summary
- Nested classes/interfaces inherited from class com.google.common.truth.Subject
  Subject.Factory<SubjectT extends Subject,ActualT>

Constructor Summary

Constructors
Modifier	Constructor	Description
`protected`	`ThrowableSubject(FailureMetadata metadata, @Nullable Throwable actual)`	The constructor is for use by subclasses only.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`ThrowableSubject`	`hasCauseThat()`	Returns a new `ThrowableSubject` to make assertions on the direct cause of the `Throwable`.
`StringSubject`	`hasMessageThat()`	Returns a `StringSubject` to make assertions about the message of the `Throwable`.

Methods inherited from class com.google.common.truth.Subject
actualCustomStringRepresentation, check, equals, failWithActual, failWithActual, failWithoutActual, hashCode, ignoreCheck, isAnyOf, isEqualTo, isIn, isInstanceOf, isNoneOf, isNotEqualTo, isNotIn, isNotInstanceOf, isNotNull, isNotSameInstanceAs, isNull, isSameInstanceAs, toString

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

- Constructor Detail
  - ThrowableSubject
```
protected ThrowableSubject(FailureMetadata metadata,
                           @Nullable Throwable actual)
```
    The constructor is for use by subclasses only. If you want to create an instance of this class itself, call check(...).that(actual).
- Method Detail
  - hasMessageThat
```
public final StringSubject hasMessageThat()
```
    Returns a StringSubject to make assertions about the message of the Throwable.
  - hasCauseThat
```
public final ThrowableSubject hasCauseThat()
```
    Returns a new ThrowableSubject to make assertions on the direct cause of the Throwable. This method can be invoked repeatedly (e.g. assertThat(e).hasCauseThat().hasCauseThat().... to assert on a particular indirect cause.