Struct Locator 

pub struct Locator { /* private fields */ }

Composable element query with actions, property queries, and auto-waiting expectations.

Locators are lazy: they describe how to find an element but do not contact the server until an action, query, or expectation method is called.

All refinement methods return a new Locator (the type is Clone), so the original remains usable.

Implementations

impl Locator

pub fn role(role: &str) -> Self

Locate elements by ARIA role (e.g. "button", "textbox").

pub fn text(text: &str) -> Self

Locate elements whose visible text contains text (case-insensitive substring).

pub fn text_exact(text: &str) -> Self

Locate elements whose visible text exactly equals text.

pub fn test_id(id: &str) -> Self

Locate elements by data-testid attribute.

pub fn css(selector: &str) -> Self

Locate elements by CSS selector.

pub fn label(text: &str) -> Self

Locate form controls by their associated <label> text.

pub fn placeholder(text: &str) -> Self

Locate elements by placeholder attribute.

pub fn alt_text(alt: &str) -> Self

Locate elements by alt attribute (images, areas).

pub fn title(title: &str) -> Self

Locate elements by title attribute.

pub fn and_text(self, text: &str) -> Self

Further filter by case-insensitive text substring.

pub fn and_text_exact(self, text: &str) -> Self

Further filter by exact text match.

pub fn and_role(self, role: &str) -> Self

Further filter by ARIA role.

pub fn name(self, name: &str) -> Self

Further filter by accessible name (case-insensitive substring).

pub fn and_tag(self, tag: &str) -> Self

Further filter by HTML tag name.

pub fn and_has_attribute( self, attr_name: &str, attr_value: Option<&str>, ) -> Self

Further filter by the presence (and optionally value) of an HTML attribute.

pub fn nth(self, n: usize) -> Self

Select the nth match (zero-based).

pub fn first(self) -> Self

Select the first match (default behavior, explicit for readability).

pub fn last(self) -> Self

Select the last match.

pub async fn click( &self, client: &mut VictauriClient, ) -> Result<Value, TestError>

Click the resolved element.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn double_click( &self, client: &mut VictauriClient, ) -> Result<Value, TestError>

Double-click the resolved element.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn fill( &self, client: &mut VictauriClient, value: &str, ) -> Result<Value, TestError>

Clear the field and fill it with value.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn type_text( &self, client: &mut VictauriClient, text: &str, ) -> Result<Value, TestError>

Type text character-by-character into the resolved element.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn press_key( &self, client: &mut VictauriClient, key: &str, ) -> Result<Value, TestError>

Press a keyboard key (e.g. "Enter", "Control+c").

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn hover( &self, client: &mut VictauriClient, ) -> Result<Value, TestError>

Hover over the resolved element.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn focus( &self, client: &mut VictauriClient, ) -> Result<Value, TestError>

Focus the resolved element.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn blur( &self, client: &mut VictauriClient, ) -> Result<Value, TestError>

Remove focus from the currently active element.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn scroll_into_view( &self, client: &mut VictauriClient, ) -> Result<Value, TestError>

Scroll the resolved element into view.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn select_option( &self, client: &mut VictauriClient, values: &[&str], ) -> Result<Value, TestError>

Select option(s) in a <select> element.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn check( &self, client: &mut VictauriClient, ) -> Result<Value, TestError>

Check a checkbox or radio button (sets checked = true).

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn uncheck( &self, client: &mut VictauriClient, ) -> Result<Value, TestError>

Uncheck a checkbox (sets checked = false).

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn text_content( &self, client: &mut VictauriClient, ) -> Result<String, TestError>

Get the textContent of the resolved element.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn inner_text( &self, client: &mut VictauriClient, ) -> Result<String, TestError>

Get the innerText of the resolved element.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn input_value( &self, client: &mut VictauriClient, ) -> Result<String, TestError>

Get the current value of an input/textarea/select element.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn is_visible( &self, client: &mut VictauriClient, ) -> Result<bool, TestError>

Whether the resolved element is visible.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn is_enabled( &self, client: &mut VictauriClient, ) -> Result<bool, TestError>

Whether the resolved element is enabled (not disabled).

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn is_checked( &self, client: &mut VictauriClient, ) -> Result<bool, TestError>

Whether the resolved element is checked (checkbox/radio).

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn is_focused( &self, client: &mut VictauriClient, ) -> Result<bool, TestError>

Whether the resolved element currently has focus.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn count( &self, client: &mut VictauriClient, ) -> Result<usize, TestError>

Count the number of elements matching this locator.

Errors

Returns errors from VictauriClient::call_tool.

pub async fn bounding_box( &self, client: &mut VictauriClient, ) -> Result<Option<Bounds>, TestError>

Get the bounding rectangle of the resolved element, if available.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn get_attribute( &self, client: &mut VictauriClient, attr_name: &str, ) -> Result<Option<String>, TestError>

Read the value of an HTML attribute on the resolved element.

Errors

Returns TestError::ElementNotFound if no element matches.

pub async fn all( &self, client: &mut VictauriClient, ) -> Result<Vec<LocatorMatch>, TestError>

Resolve all matching elements (ignoring the pick setting).

Errors

Returns errors from VictauriClient::call_tool.

pub async fn all_text_contents( &self, client: &mut VictauriClient, ) -> Result<Vec<String>, TestError>

Get textContent for every matching element.

Errors

Returns errors from VictauriClient::call_tool.

pub fn expect<'a>(&'a self, client: &'a mut VictauriClient) -> LocatorExpect<'a>

Create an auto-waiting expectation builder for this locator.

Trait Implementations

impl Clone for Locator

fn clone(&self) -> Locator

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Locator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Locator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.