Struct RobotTestRule 

pub struct RobotTestRule<R>
where
    R: Renderer,
{ /* private fields */ }

Main robot testing rule that provides programmatic control over a real app.

This is similar to Jetpack Compose’s ComposeTestRule but for full app testing with real rendering and input simulation.

Implementations

impl<R> RobotTestRule<R>

where R: Renderer, R::Error: Debug,

pub fn new( width: u32, height: u32, renderer: R, content: impl FnMut() + 'static, ) -> Self

Create a new robot test rule with the given viewport size and app content.

The app will be launched immediately with the provided dimensions.

pub fn viewport_size(&self) -> (u32, u32)

Get the current viewport size.

pub fn set_viewport(&mut self, width: u32, height: u32)

Resize the viewport (simulates window resize).

pub fn advance_time(&mut self, _nanos: u64)

Advance frame time by the given duration in nanoseconds.

This is useful for testing animations and time-based behaviors.

pub fn wait_for_idle(&mut self)

Pump the app until it’s idle (no pending updates).

This ensures all compositions, layouts, and renders have completed.

pub fn click_at(&mut self, x: f32, y: f32) -> bool

Perform a click at the given coordinates.

Returns true if the click hit a UI element, false otherwise.

pub fn move_to(&mut self, x: f32, y: f32) -> bool

Move the cursor to the given coordinates.

Returns true if the move hit a UI element, false otherwise.

pub fn drag(&mut self, from_x: f32, from_y: f32, to_x: f32, to_y: f32)

Perform a drag from one point to another.

This simulates a pointer down, move, and up sequence.

pub fn mouse_move(&mut self, x: f32, y: f32)

Move the mouse cursor to the given coordinates.

pub fn mouse_down(&mut self)

Press the mouse button.

pub fn mouse_up(&mut self)

Release the mouse button.

pub fn find_by_text(&mut self, text: &str) -> ElementFinder<'_, R>

Find an element by text content.

Returns a finder that can be used to interact with or assert on the element.

pub fn find_at_position(&mut self, x: f32, y: f32) -> ElementFinder<'_, R>

Find an element at the given position.

Returns a finder for the topmost element at that position.

pub fn find_clickable(&mut self) -> ElementFinder<'_, R>

Find all clickable elements.

Returns a finder that matches all elements with clickable semantics.

pub fn get_all_text(&mut self) -> Vec<String>

Get all text content currently visible on screen.

This is useful for debugging or asserting on overall screen state.

pub fn get_all_rects(&mut self) -> Vec<(Rect, Option<String>)>

Get all rectangles (bounds) of UI elements on screen.

Returns a list of (bounds, optional_text) tuples.

pub fn dump_screen(&mut self)

Print debug information about the current screen state.

This outputs the layout tree and render scene for debugging.

pub fn shell_mut(&mut self) -> &mut AppShell<R>

Get access to the underlying app shell for advanced scenarios.