# FailureHandler

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/FailureHandler.java+class:androidx.test.espresso.FailureHandler)

*** ** * ** ***


```
interface FailureHandler
```

<br />

Known direct subclasses [DefaultFailureHandler](https://developer.android.com/reference/kotlin/androidx/test/espresso/base/DefaultFailureHandler)

|---|---|
| `https://developer.android.com/reference/kotlin/androidx/test/espresso/base/DefaultFailureHandler` | Espresso's default `https://developer.android.com/reference/kotlin/androidx/test/espresso/FailureHandler`. |

*** ** * ** ***

Handles failures that happen during test execution.

## Summary

| ### Public functions |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/test/espresso/FailureHandler#handle(java.lang.Throwable,org.hamcrest.Matcher<android.view.View>)(error: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html!, viewMatcher: https://junit.org/junit4/javadoc/latest/org/hamcrest/Matcher.html<https://developer.android.com/reference/android/view/View.html!>!)` 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 functions

### handle

```
fun handle(error: Throwable!, viewMatcher: Matcher<View!>!): Unit
```

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.