# TestFailurePolicy.CaptureMode

Artifact: [androidx.compose.ui:ui-test](https://developer.android.com/jetpack/androidx/releases/compose-ui) [View Source](https://cs.android.com/search?q=file:androidx/compose/ui/test/ComposeUiTestConfig.+class:androidx.compose.ui.test.TestFailurePolicy.CaptureMode) Added in [1.13.0-rc01](https://developer.android.com/jetpack/androidx/releases/compose-ui#1.13.0-rc01) Common/AllAndroid/JVM
- Cmn

  ```
  value class TestFailurePolicy.CaptureMode
  ```

*** ** * ** ***

Represents a tri-state flag for failure artifact captures, allowing individual test configurations to explicitly override or fall back to suite-level runner arguments.

This is used within `https://developer.android.com/reference/kotlin/androidx/compose/ui/test/TestFailurePolicy` to dictate whether the test framework should capture diagnostic artifacts (like screenshots or UI hierarchy dumps) when a test fails.

## Summary

| ### Public companion properties |
|---|---|---|
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/test/TestFailurePolicy.CaptureMode` | `https://developer.android.com/reference/kotlin/androidx/compose/ui/test/TestFailurePolicy.CaptureMode#Disabled()` Explicitly disable the capture for this test, overriding runner configuration. | Cmn android |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/test/TestFailurePolicy.CaptureMode` | `https://developer.android.com/reference/kotlin/androidx/compose/ui/test/TestFailurePolicy.CaptureMode#Enabled()` Explicitly enable the capture for this test, overriding runner configuration. | Cmn android |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/test/TestFailurePolicy.CaptureMode` | `https://developer.android.com/reference/kotlin/androidx/compose/ui/test/TestFailurePolicy.CaptureMode#Unspecified()` Fall back to the suite-level runner configuration. | Cmn android |

| ### Public functions |
|---|---|---|
| `open https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html` | `https://developer.android.com/reference/kotlin/androidx/compose/ui/test/TestFailurePolicy.CaptureMode#toString()()` | android |

## Public companion properties

### Disabled

Cmn android

```
val Disabled: TestFailurePolicy.CaptureMode
```

Explicitly disable the capture for this test, overriding runner configuration.

### Enabled

Cmn android

```
val Enabled: TestFailurePolicy.CaptureMode
```

Explicitly enable the capture for this test, overriding runner configuration.

### Unspecified

Cmn android

```
val Unspecified: TestFailurePolicy.CaptureMode
```

Fall back to the suite-level runner configuration.

## Public functions

### toString

android

```
open fun toString(): String
```