{% setvar book_path %}/reference/androidx/_book.yaml{% endsetvar %} {% include "_shared/_reference-head-tags.html" %}

IdlingPolicies

public final class IdlingPolicies

Allows users fine grain control over idling policies.

Espresso's default idling policies are suitable for most usecases - however certain execution environments (like the ARM emulator) might be very slow. This class allows users the ability to adjust defaults to sensible values for their environments.

Summary

Public constructors
`IdlingPolicies()`

Public methods
`static IdlingPolicy`	`getDynamicIdlingResourceErrorPolicy()`
`static IdlingPolicy`	`getDynamicIdlingResourceWarningPolicy()`
`static IdlingPolicy`	`getMasterIdlingPolicy()`
`static void`	`setIdlingResourceTimeout(long timeout, TimeUnit unit)` Updates the IdlingPolicy used by IdlingResourceRegistry to determine when IdlingResources timeout.
`static void`	`setMasterPolicyTimeout(long timeout, TimeUnit unit)` Updates the IdlingPolicy used in UiController.loopUntil to detect AppNotIdleExceptions.
`static void`	`setMasterPolicyTimeoutWhenDebuggerAttached( boolean timeoutWhenDebuggerAttached )` This method overrides Espresso's default behaviour of disabling timeouts when a step debugger is attached to the VM.

Public constructors

IdlingPolicies

public final IdlingPolicies()

Public methods

getDynamicIdlingResourceErrorPolicy

public static IdlingPolicy getDynamicIdlingResourceErrorPolicy()

getDynamicIdlingResourceWarningPolicy

public static IdlingPolicy getDynamicIdlingResourceWarningPolicy()

getMasterIdlingPolicy

public static IdlingPolicy getMasterIdlingPolicy()

setIdlingResourceTimeout

public static void setIdlingResourceTimeout(long timeout, TimeUnit unit)

Updates the IdlingPolicy used by IdlingResourceRegistry to determine when IdlingResources timeout.

Parameters
`long timeout`	the timeout before an IdlingResourceTimeoutException is created.
`TimeUnit unit`	the unit of the timeout value.

setMasterPolicyTimeout

public static void setMasterPolicyTimeout(long timeout, TimeUnit unit)

Updates the IdlingPolicy used in UiController.loopUntil to detect AppNotIdleExceptions.

Parameters
`long timeout`	the timeout before an AppNotIdleException is created.
`TimeUnit unit`	the unit of the timeout value.

setMasterPolicyTimeoutWhenDebuggerAttached

public static void setMasterPolicyTimeoutWhenDebuggerAttached(
    boolean timeoutWhenDebuggerAttached
)

This method overrides Espresso's default behaviour of disabling timeouts when a step debugger is attached to the VM. Setting the timeout flag reenables the behaviour of throwing a timeout exception.

The value set in this method is superceded if unsafeMakeMasterPolicyWarning is also called.