Struct Locator 

pub struct Locator { /* private fields */ }

A locator for finding and interacting with elements.

Per spec Section 6.1.1: “Unlike Selenium, Locators are strict and auto-wait.”

Implementations

impl Locator

pub fn new(selector: impl Into<String>) -> Self

Create a new locator with a CSS selector

pub fn from_selector(selector: Selector) -> Self

Create a locator from a selector

pub fn with_text(self, text: impl Into<String>) -> Self

Filter by text content

Per spec: page.locator("button").with_text("Start Game")

pub fn entity(self, name: impl Into<String>) -> Self

Filter to a specific WASM game entity

Per spec: page.locator("canvas").entity("hero")

pub const fn with_timeout(self, timeout: Duration) -> Self

Set a custom timeout

pub const fn with_strict(self, strict: bool) -> Self

Disable strict mode (allow multiple matches)

pub const fn with_visible(self, visible: bool) -> Self

Set visibility requirement

pub const fn selector(&self) -> &Selector

Get the selector

pub const fn options(&self) -> &LocatorOptions

Get the options

pub fn click(&self) -> ProbarResult<LocatorAction>

Simulate clicking on the located element

Errors

Returns error if element not found or not clickable

pub fn double_click(&self) -> ProbarResult<LocatorAction>

Simulate double-clicking on the located element

Errors

Returns error if element not found or not clickable

pub fn drag_to(&self, target: &Point) -> DragBuilder

Drag the located element to a target point

Per spec: hero.drag_to(&Point::new(500.0, 500.0)).steps(10).duration(...)

pub fn fill(&self, text: impl Into<String>) -> ProbarResult<LocatorAction>

Fill the located element with text

Errors

Returns error if element not found or not fillable

pub fn text_content(&self) -> ProbarResult<LocatorQuery>

Get the text content of the located element

Errors

Returns error if element not found

pub fn is_visible(&self) -> ProbarResult<LocatorQuery>

Check if the element is visible

pub fn bounding_box(&self) -> ProbarResult<LocatorQuery>

Get the bounding box of the located element

pub fn wait_for_visible(&self) -> ProbarResult<LocatorAction>

Wait for the element to be visible

pub fn wait_for_hidden(&self) -> ProbarResult<LocatorAction>

Wait for the element to be hidden

pub fn count(&self) -> ProbarResult<LocatorQuery>

Check the element count (for assertions)

pub fn filter(self, options: FilterOptions) -> Self

Filter the locator by additional conditions

Per Playwright: locator.filter({ hasText: 'Hello', has: page.locator('.child') })

pub fn and(self, other: Locator) -> Self

Create intersection of two locators (both must match)

Per Playwright: locator.and(other)

pub fn or(self, other: Locator) -> Self

Create union of two locators (either can match)

Per Playwright: locator.or(other)

pub fn first(self) -> Self

Get the first matching element

Per Playwright: locator.first()

pub fn last(self) -> Self

Get the last matching element

Per Playwright: locator.last()

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

Get the element at the specified index

Per Playwright: locator.nth(index)

pub fn right_click(&self) -> ProbarResult<LocatorAction>

Simulate right-clicking on the located element

Per Playwright: locator.click({ button: 'right' })

pub fn click_with_options( &self, options: ClickOptions, ) -> ProbarResult<LocatorAction>

Click with custom options

Per Playwright: locator.click(options)

pub fn hover(&self) -> ProbarResult<LocatorAction>

Hover over the located element

Per Playwright: locator.hover()

pub fn focus(&self) -> ProbarResult<LocatorAction>

Focus the located element

Per Playwright: locator.focus()

pub fn blur(&self) -> ProbarResult<LocatorAction>

Remove focus from the located element

Per Playwright: locator.blur()

pub fn check(&self) -> ProbarResult<LocatorAction>

Check a checkbox or radio button

Per Playwright: locator.check()

pub fn uncheck(&self) -> ProbarResult<LocatorAction>

Uncheck a checkbox

Per Playwright: locator.uncheck()

pub fn scroll_into_view(&self) -> ProbarResult<LocatorAction>

Scroll element into view if needed

Per Playwright: locator.scrollIntoViewIfNeeded()

pub fn by_role(role: impl Into<String>) -> Self

Create a locator by ARIA role

pub fn by_role_with_name( role: impl Into<String>, name: impl Into<String>, ) -> Self

Create a locator by ARIA role with name

pub fn by_label(text: impl Into<String>) -> Self

Create a locator by label text

pub fn by_placeholder(text: impl Into<String>) -> Self

Create a locator by placeholder text

pub fn by_alt_text(text: impl Into<String>) -> Self

Create a locator by alt text

pub fn by_test_id(id: impl Into<String>) -> Self

Create a locator by test ID

pub fn by_text(text: impl Into<String>) -> Self

Create a locator by text content

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.