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
```
Propositions for Throwable subjects.
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);
 
```
Author:

Kurt Alfred Kluever

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 throwable)
Constructor for use by subclasses.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`ThrowableSubject`	`hasCauseThat()`	Returns a new `ThrowableSubject` that supports assertions on this throwable's direct cause.
`StringSubject`	`hasMessageThat()`	Returns a `StringSubject` to make assertions about the throwable's message.

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 throwable)
```
    Constructor for use by subclasses. 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 throwable's message.
  - hasCauseThat
```
public final ThrowableSubject hasCauseThat()
```
    Returns a new ThrowableSubject that supports assertions on this throwable's direct cause. This method can be invoked repeatedly (e.g. assertThat(e).hasCauseThat().hasCauseThat().... to assert on a particular indirect cause.