ui-test

Creates an AndroidComposeUiTestEnvironment that retrieves the host ActivityAndroidComposeUiTest.activity by delegating to the given activityProvider.

A DeviceConfigurationOverride that overrides the dark mode or light mode theme for the contained content.

A DeviceConfigurationOverride that overrides the font weight adjustment for the contained content.

A DeviceConfigurationOverride that overrides the current keyboard type.

A DeviceConfigurationOverride that overrides the locales for the contained content.

A DeviceConfigurationOverride that overrides the current navigation type and whether it is hidden.

A DeviceConfigurationOverride that overrides whether the screen is round for the contained content.

A DeviceConfigurationOverride that overrides the current touchscreen type.

A DeviceConfigurationOverride that overrides the current ui mode type.

A DeviceConfigurationOverride that overrides the window insets for the contained content.

Adds a named assertion to the collection of assertions to be executed before test actions.

Adds the given durationMillis to the current event time, delaying the next event by that time.

Move the mouse along the given curve, sending a stream of move events to get an animated path of durationMillis milliseconds.

Move the mouse from the current positionMouseInjectionScope.currentPosition by the given delta, sending a stream of move events to get an animated path of durationMillis milliseco…

Move the mouse from the current positionMouseInjectionScope.currentPosition to the given position, sending a stream of move events to get an animated path of durationMillis millis…

Asserts that the provided matcher is satisfied for this node.

Asserts that all the nodes in this collection satisfy the given matcher.

Asserts that this collection contains at least one element that satisfies the given matcher.

Asserts that the node's list of content descriptions contains the given value.

Asserts that the node's list of content descriptions contains exactly the given values and nothing else.

Asserts that this collection of nodes is equal to the given expectedSize.

Asserts that the current semantics node has a click action.

Asserts that the current semantics node has doesn't have a click action.

Asserts that the layout of this node has height that is greater than or equal to expectedMinHeight.

Asserts that the layout of this node has height equal to expectedHeight.

Asserts that the current semantics node is displayed on screen.

Asserts that the current semantics node is enabled.

Asserts that this value is equal to the given expected value.

Asserts that the current semantics node has a focus.

Asserts that the current semantics node is not displayed on screen, including when the node is not composed, composed but not placed, or when none of its bounds are visible on scr…

Asserts that the current semantics node is not enabled.

Asserts that the current semantics node does not have a focus.

Asserts that the current semantics node is not selected.

Asserts that the current semantics node is unchecked.

Asserts that the current semantics node is checked.

Asserts that the current semantics node is selectable.

Asserts that the current semantics node is selected.

Asserts that the current semantics node is toggleable.

Asserts that the layout of this node has the left position in the root composable that is equal to the given position.

Asserts that the layout of this node has position in the root composable that is equal to the given position.

Asserts the node's range info equals the given value.

Asserts that the node's list of text values contains the given value.

Asserts that the node's list of text values contains exactly the given values and nothing else.

Asserts that the layout of this node has the top position in the root composable that is equal to the given position.

Asserts that the touch bounds of this node has height equal to expectedHeight.

Asserts that the touch bounds of this node has width equal to expectedWidth.

Asserts the node's value equals the given value.

Asserts that the layout of this node has width that is greater than or equal to expectedMinWidth.

Asserts that the layout of this node has width equal to expectedWidth.

Sends a cancel event to cancel the current gesture.

Captures the underlying semantics node's surface into an ImageBitmap.

Performs a click gesture at the given position on the associated node, or in the center if the position is omitted.

Performs a double click gesture at the given position on the associated node, or in the center if the position is omitted.

Sends a down event for the pointer with the given pointerId at position on the associated node.

Use button to drag and drop something from start to end in durationMillis milliseconds.

Returns all the nodes matching the given matcher.

Expects to return exactly one node matching the given matcher.

Returns the position of an alignment lineAlignmentLine, or Dp.Unspecified if the line is not provided.

Returns the bounds of the layout of this node as clipped to the root.

Returns the bounds of the first link matching the predicate, or if that link spans multiple lines, returns the bounds of the first line of the link.

Returns the bounds of the layout of this node.

Returns whether the node has at least one ancestor that satisfies the given matcher.

Returns whether the node has at least one child that satisfies the given matcher.

Returns whether the node has at least one descendant that satisfies the given matcher.

Returns whether the node has at least one sibling that satisfies the given matcher.

Return whether the node has a semantics click action defined.

Returns whether the node's content description contains the given value.

Returns whether the node's content description contains exactly the given values and nothing else.

Returns whether the node defines the given IME action.

Returns whether the node defines a semantics action to insert text on it.

Return whether the node has no semantics click action defined.

Return whether the node has no semantics scrollable action defined.

Returns whether the node's parent satisfies the given matcher.

Returns whether the node defines a semantics action to perform the IME actionSemanticsProperties.ImeAction on it.

Returns whether the node's range info matches exactly to the given accessibility range info.

Returns whether the node defines a semantics action to request focus.

Return whether the node has a semantics scrollable action defined.

Returns whether the node defines the ability to scroll to an item index.

Returns whether the node defines the ability to scroll to an item identified by a key, such as LazyColumnandroidx.compose.foundation.lazy.LazyColumn or LazyRowandroidx.compose.fou…

Returns whether the node defines the ability to scroll to content identified by a matcher.

Returns whether the node defines a semantics action to set text on it.

Returns whether the node's value matches exactly to the given accessibility value.

Returns whether the node is annotated by the given test tag.

Returns whether the node's text contains the given text.

Returns whether the node's text contains exactly the given textValues and nothing else.

Executes all of the assertions registered by addGlobalAssertion.

Returns whether the node is a dialog.

Returns true if the matched node is displayed on screen.

Returns whether the node is editable.

Returns whether the node is enabled.

Return whether the node is able to receive focus

Returns whether the node is focused.

Returns whether the node is marked as an accessibility header.

Returns whether the node is hidden from accessibility.

Capability query to determine if the current ComposeUiTest implementation supports registering an IdlingResource.

Returns true if the matched node is not displayed on screen, including when the node is not composed, composed but not placed, or when none of its bounds are visible on screen aft…

Returns whether the node is not enabled.

Return whether the node is not able to receive focus.

Returns whether the node is not focused.

Returns whether the node is not selected.

Returns whether the node is not toggled.

Returns whether the node is toggled.

Returns whether the node is a popup.

Return whether the node is the root semantics node.

Return whether the node is selectable.

Returns whether the node is selected.

Return whether the node is checkable.

Performs a long click gesture at the given position on the associated node, or in the center if the position is omitted.

Sends a move event without updating any of the pointer positions.

Sends a move event on the associated node, with the position of the pointer with the given pointerId moved by the given delta.

Moves the position of the pointer with the given pointerId by the given delta, but does not send a move event.

Updates the position of the pointer with the given pointerId to the given position, but does not send a move event.

Sends a move event on the associated node, with the position of the pointer with the given pointerId updated to position.

Performs a multitouch swipe gesture on nodes in the focus path.

Finds all semantics nodes with the given label as content description.

Finds all semantics nodes identified by the given tag.

Finds all semantics nodes with the given text.

Returns all the ancestors of this node.

Returns exactly one child of this node.

Returns child of this node at the given index.

Returns children of this node at the moment of invocation, it only captures nodes that are currently present in the semantic tree.

Returns all the descendants of this node in Depth-First Search order.

Returns the first node in this collection.

Returns the last node in this collection.

Finds a semantics node with the given content description.

Finds a semantics node identified by the given tag.

Finds a semantics node with the given text.

Returns a parent of this node.

Finds the root semantics node of the Compose tree.

Scopes Compose interactions to the View hierarchy matched by an Espresso ViewInteraction.

Returns exactly one sibling of this node.

Returns all siblings of this node.

Sends a pan gesture with the given total offset.

Performs a pan gesture on the associated node such that it ends with the given endVelocity.

Creates an Offset relative to the size of the node we're interacting with.

Performs a click action on the element represented by the given semantics node.

Finds the CustomAccessibilityAction in the node's CustomActions list whose label is equal to label and then invokes it.

Finds the CustomAccessibilityAction in the node's CustomActions list whose label satisfies a predicate function and then invokes it.

For a first link matching the predicate performs a click on it.

Executes the (partial) gesture specified in the given block.

Sends to this node the IME action associated with it in a similar way to the IME.

Executes the key input gesture specified in the given block.

Send the specified KeyEvent to the focused component.

Executes the mouse gesture specified in the given block.

Executes the multi-modal gesture specified in the given block.

Executes the rotary input specified in the given block.

Scrolls the closest enclosing scroll parent by the smallest amount such that this node is fully visible in its viewport.

Scrolls a scrollable container with items to the item with the given index.

Scrolls a scrollable container with keyed items to the item with the given key, such as LazyColumnandroidx.compose.foundation.lazy.LazyColumn or LazyRowandroidx.compose.foundation…

Scrolls a scrollable container to the content that matches the given matcher.

Provides support to call custom semantics actions on this node.

Clears the text in this node in similar way to IME.

Sends the given text to this node in similar way to IME.

Sends the given selection to this node in similar way to IME.

Replaces existing text with the given text in this node in similar way to IME.

Executes the touch gesture specified in the given block.

Executes the trackpad gesture specified in the given block.

Performs a pinch gesture on the associated node.

Holds down the given key for the given pressDurationMillis by sending a key down event, advancing the event time and sending a key up event.

Prints all the semantics nodes information into logs (as debug level).

Prints all the semantics nodes information it holds into string.

Attempts to register an IdlingResource in this test.

Removes a named assertion from the collection of assertions to be executed before test actions.

Requests the focus system to give focus to this node by invoking the RequestFocusSemanticsActions.RequestFocus semantics action.

Secondary-click on position, or on the current mouse position if position is unspecifiedOffset.Unspecified.

Variant of runComposeUiTest that allows you to specify which Activity should be launched.

Sets up the test environment, runs the given testblock and then tears down the test environment.

Variant of runComposeUiTest that does not launch an Activity to host Compose content in and thus acts as an "empty shell".

Sends a scale event with the given scaleFactor.

Sends an indirect pointer gesture globally, targeting the currently focused Compose UI (from root to the focused node).

Rotate the mouse's scrollWheel by the given scrollAmount.

Performs the swipe gesture on the associated node.

Performs a swipe down gesture along the centerX of the associated node.

Performs a swipe left gesture along the centerY of the associated node.

Performs a swipe right gesture along the centerY of the associated node.

Performs a swipe up gesture along the centerX of the associated node.

Performs the swipe gesture on the associated node, such that the velocity when the gesture is finished is roughly equal to endVelocity.

Combines this override with the other override into a single override, by applying this override as the outer override first, then the other override as an inner override, and the…

Use button to triple-click on position, or on the current mouse position if position is unspecifiedOffset.Unspecified.

Attempts to unregister an IdlingResource in this test.

Sends an up event for the pointer with the given pointerId, or the default pointer if pointerId is omitted, on the associated node.

Blocks until at least one node matches the given matcher.

Blocks until no nodes match the given matcher.

Blocks until exactly one node matches the given matcher.

Blocks until the number of nodes matching the given matcher is equal to the given count.

Executes the keyboard sequence specified in the given block, whilst holding down the given key.

Executes the keyboard sequence specified in the given block, in between presses to the given key.

Executes the keyboard sequence specified in the given block, whilst holding down the each of the given keys.

Executes the keyboard sequence specified in the given block, in between presses to the given keys.