Expect

java.lang.Object
- com.google.common.truth.StandardSubjectBuilder
- - com.google.common.truth.Expect

All Implemented Interfaces:

org.junit.rules.TestRule
```
public final class Expect
extends StandardSubjectBuilder
implements org.junit.rules.TestRule
```
A TestRule that batches up all failures encountered during a test, and reports them all together at the end (similar to ErrorCollector). It is also useful for making assertions from other threads or from within callbacks whose exceptions would be swallowed or logged, rather than propagated out to fail the test. (AssertJ has a similar feature called "soft assertions"; however, soft assertions are not safe for concurrent use.)
Usage:
```
 @Rule public final Expect expect = Expect.create();

 ...

   expect.that(results).containsExactly(...);
   expect.that(errors).isEmpty();
 
```
If both of the assertions above fail, the test will fail with an exception that contains information about both.
Expect may be used concurrently from multiple threads. Note, however, that Expect has no way of knowing when all your other test threads are done. It simply checks for failures when the main thread finishes executing the test method. Thus, you must ensure that any background threads complete their assertions before then, or your test may ignore their results.
To record failures for the purpose of testing that an assertion fails when it should, see ExpectFailure.

Nested Class Summary

Nested Classes
Modifier and Type Class Description

private static class Expect.ExpectationGatherer

(package private) static class Expect.TestPhase

Field Summary

Fields
Modifier and Type Field Description

private Expect.ExpectationGatherer gatherer

Constructor Summary

Constructors
Modifier Constructor Description

private Expect(Expect.ExpectationGatherer gatherer)

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`org.junit.runners.model.Statement`	`apply(org.junit.runners.model.Statement base, org.junit.runner.Description description)`
`(package private) void`	`checkStatePreconditions()`	Extension point invoked before every assertion.
`static Expect`	`create()`	Creates a new instance.
`boolean`	`hasFailures()`

Methods inherited from class com.google.common.truth.StandardSubjectBuilder
about, about, fail, forCustomFailureStrategy, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, that, withMessage, withMessage

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

- Field Detail
  - gatherer
```
private final Expect.ExpectationGatherer gatherer
```
- Constructor Detail
  - Expect
```
private Expect(Expect.ExpectationGatherer gatherer)
```
- Method Detail
  - create
```
public static Expect create()
```
    Creates a new instance.
  - hasFailures
```
public boolean hasFailures()
```
  - checkStatePreconditions
```
void checkStatePreconditions()
```
    Description copied from class: StandardSubjectBuilder
    
    Extension point invoked before every assertion. This allows Expect to check that it's been set up properly as a TestRule.
    
    Overrides:
    
    checkStatePreconditions in class StandardSubjectBuilder
  - apply
```
public org.junit.runners.model.Statement apply(org.junit.runners.model.Statement base,
                                               org.junit.runner.Description description)
```
    Specified by:
    
    apply in interface org.junit.rules.TestRule