IdlingPolicies

public final class IdlingPolicies
extends Object

java.lang.Object
   ↳ android.support.test.espresso.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 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.

Inherited methods

From class java.lang.Object

Public methods

getDynamicIdlingResourceErrorPolicy

IdlingPolicy getDynamicIdlingResourceErrorPolicy ()

Returns
IdlingPolicy

getDynamicIdlingResourceWarningPolicy

IdlingPolicy getDynamicIdlingResourceWarningPolicy ()

Returns
IdlingPolicy

getMasterIdlingPolicy

IdlingPolicy getMasterIdlingPolicy ()

Returns
IdlingPolicy

setIdlingResourceTimeout

void setIdlingResourceTimeout (long timeout, 
                TimeUnit unit)

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

Parameters
timeout long: the timeout before an IdlingResourceTimeoutException is created.

unit TimeUnit: the unit of the timeout value.

setMasterPolicyTimeout

void setMasterPolicyTimeout (long timeout, 
                TimeUnit unit)

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

Parameters
timeout long: the timeout before an AppNotIdleException is created.

unit TimeUnit: the unit of the timeout value.

setMasterPolicyTimeoutWhenDebuggerAttached

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 ERROR(/#unsafeMakeMasterPolicyWarning()) is also called.

Parameters
timeoutWhenDebuggerAttached boolean