Espresso's default FailureHandler. If this does not fit your needs, feel free to provide
your own implementation via Espresso.setFailureHandler(FailureHandler).
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.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-10 UTC."],[],[],null,["# DefaultFailureHandler\n\nSummary: [Ctors](#pubctors) \\| [Methods](#pubmethods) \\| [Inherited Methods](#inhmethods) \\| [\\[Expand All\\]](#) \n\nDefaultFailureHandler\n=====================\n\n| This package is part of the Android [support library](/topic/libraries/support-library) which is no longer maintained. The support library has been superseded by [AndroidX](/jetpack/androidx) which is part of [Jetpack](/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider [migrating](/jetpack/androidx/migrate) existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library [class\n| mappings](/jetpack/androidx/migrate/class-mappings).\n\n\n`\npublic\n\nfinal\n\nclass\nDefaultFailureHandler\n`\n\n\n`\n\nextends `[Object](https://developer.android.com/reference/java/lang/Object.html)`\n\n\n`\n\n`\n\n\nimplements\n\n`[FailureHandler](/reference/android/support/test/espresso/FailureHandler)`\n\n\n`\n\n|---|----------------------------------------------------------|\n| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) ||\n| ↳ | android.support.test.espresso.base.DefaultFailureHandler |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nEspresso's default [FailureHandler](/reference/android/support/test/espresso/FailureHandler). If this does not fit your needs, feel free to provide\nyour own implementation via Espresso.setFailureHandler(FailureHandler).\n\nSummary\n-------\n\n| ### Public constructors ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ` `[DefaultFailureHandler](/reference/android/support/test/espresso/base/DefaultFailureHandler#DefaultFailureHandler(android.content.Context))`(`[Context](https://developer.android.com/reference/android/content/Context.html)` appContext) ` |\n\n| ### Public methods ||\n|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` void` | ` `[handle](/reference/android/support/test/espresso/base/DefaultFailureHandler#handle(java.lang.Throwable, org.hamcrest.Matcher\u003candroid.view.View\u003e))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable.html)` error, Matcher\u003c`[View](https://developer.android.com/reference/android/view/View.html)`\u003e viewMatcher) ` Handle the given error in a manner that makes sense to the environment in which the test is executed (e.g. |\n\n| ### Inherited methods |\n|-----------------------|---|\n| From class ` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object.html)` ` |-------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object.html) | ` clone() ` | | ` boolean` | ` equals(`[Object](https://developer.android.com/reference/java/lang/Object.html)` arg0) ` | | ` void` | ` finalize() ` | | ` final `[Class](https://developer.android.com/reference/java/lang/Class.html)`\u003c?\u003e` | ` getClass() ` | | ` int` | ` hashCode() ` | | ` final void` | ` notify() ` | | ` final void` | ` notifyAll() ` | | ` `[String](https://developer.android.com/reference/java/lang/String.html) | ` toString() ` | | ` final void` | ` wait(long arg0, int arg1) ` | | ` final void` | ` wait(long arg0) ` | | ` final void` | ` wait() ` | ||\n| From interface ` `[android.support.test.espresso.FailureHandler](/reference/android/support/test/espresso/FailureHandler)` ` |------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract void` | ` `[handle](/reference/android/support/test/espresso/FailureHandler#handle(java.lang.Throwable, org.hamcrest.Matcher\u003candroid.view.View\u003e))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable.html)` error, Matcher\u003c`[View](https://developer.android.com/reference/android/view/View.html)`\u003e viewMatcher) ` Handle the given error in a manner that makes sense to the environment in which the test is executed (e.g. | ||\n\nPublic constructors\n-------------------\n\n### DefaultFailureHandler\n\n```\nDefaultFailureHandler (Context appContext)\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Parameters ||\n|--------------|------------------|\n| `appContext` | `Context` \u003cbr /\u003e |\n\nPublic methods\n--------------\n\n### handle\n\n```\nvoid handle (Throwable error, \n Matcher\u003cView\u003e viewMatcher)\n```\n\nHandle the given error in a manner that makes sense to the environment in which the test is\nexecuted (e.g. take a screenshot, output extra debug info, etc). Upon handling, most handlers\nwill choose to propagate the error.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|---------------|--------------------|\n| `error` | `Throwable` \u003cbr /\u003e |\n| `viewMatcher` | `Matcher` \u003cbr /\u003e |\n\n-\n\n Annotations\n -----------\n\n - [Default](/reference/android/support/test/espresso/base/Default)\n - [MainThread](/reference/android/support/test/espresso/base/MainThread)\n - [RootViewPickerScope](/reference/android/support/test/espresso/base/RootViewPickerScope)\n-\n\n Interfaces\n ----------\n\n - [ActiveRootLister](/reference/android/support/test/espresso/base/ActiveRootLister)\n - [IdlingUiController](/reference/android/support/test/espresso/base/IdlingUiController)\n - [InterruptableUiController](/reference/android/support/test/espresso/base/InterruptableUiController)\n-\n\n Classes\n -------\n\n - [DefaultFailureHandler](/reference/android/support/test/espresso/base/DefaultFailureHandler)\n - [IdlingResourceRegistry](/reference/android/support/test/espresso/base/IdlingResourceRegistry)\n - [RootViewPicker](/reference/android/support/test/espresso/base/RootViewPicker)\n - [ViewFinderImpl](/reference/android/support/test/espresso/base/ViewFinderImpl)"]]
From
class