# DefaultFailureHandler

Artifact: [androidx.test.espresso:espresso-core](https://developer.android.com/jetpack/androidx/releases/test-espresso) [View Source](https://cs.android.com/search?q=file:androidx/test/espresso/base/DefaultFailureHandler.java+class:androidx.test.espresso.base.DefaultFailureHandler)

*** ** * ** ***


```
public final class DefaultFailureHandler implements FailureHandler
```

<br />

*** ** * ** ***

Espresso's default `https://developer.android.com/reference/androidx/test/espresso/FailureHandler`. If this does not fit your needs, feel free to provide your own implementation via Espresso.setFailureHandler(FailureHandler).

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/test/espresso/base/DefaultFailureHandler#DefaultFailureHandler(android.content.Context)(https://developer.android.com/reference/android/content/Context.html appContext)` |
| `https://developer.android.com/reference/androidx/test/espresso/base/DefaultFailureHandler#DefaultFailureHandler(android.content.Context,boolean)( https://developer.android.com/reference/android/content/Context.html appContext, boolean captureScreenshotOnFailure )` |

| ### Public methods |
|---|---|
| `void` | `https://developer.android.com/reference/androidx/test/espresso/base/DefaultFailureHandler#handle(java.lang.Throwable,org.hamcrest.Matcher<android.view.View>)(https://developer.android.com/reference/java/lang/Throwable.html error, https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/view/View.html> viewMatcher)` Handle the given error in a manner that makes sense to the environment in which the test is executed (e.g. take a screenshot, output extra debug info, etc). |

## Public constructors

### DefaultFailureHandler

```
public DefaultFailureHandler(Context appContext)
```

### DefaultFailureHandler

```
public DefaultFailureHandler(
    Context appContext,
    boolean captureScreenshotOnFailure
)
```

## Public methods

### handle

```
public void handle(Throwable error, Matcher<View> viewMatcher)
```

Handle the given error in a manner that makes sense to the environment in which the test is executed (e.g. take a screenshot, output extra debug info, etc). Upon handling, most handlers will choose to propagate the error.