Struct FrameElementLocator 

pub struct FrameElementLocator<'a> { /* private fields */ }

A locator for elements within a frame.

This combines a FrameLocator with an element Selector to locate elements inside an iframe.

Implementations

impl<'a> FrameElementLocator<'a>

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

Set a custom timeout for this locator.

pub fn locator(&self, selector: impl Into<String>) -> FrameElementLocator<'a>

Create a child locator that further filters elements.

pub fn first(&self) -> FrameElementLocator<'a>

Select the first matching element.

pub fn last(&self) -> FrameElementLocator<'a>

Select the last matching element.

pub fn nth(&self, index: i32) -> FrameElementLocator<'a>

Select the nth matching element (0-indexed).

pub fn frame_locator(&self) -> &FrameLocator<'a>

Get the frame locator.

pub fn selector(&self) -> &Selector

Get the selector.

impl FrameElementLocator<'_>

pub async fn click(&self) -> Result<(), LocatorError>

Click the element within the frame.

Waits for the element to be visible and enabled, then clicks its center.

Errors

Returns an error if the frame or element is not found, not visible, or the click fails.

pub async fn fill(&self, text: &str) -> Result<(), LocatorError>

Fill the element with text (clears existing content first).

Errors

Returns an error if the element cannot be focused or text cannot be inserted.

pub async fn type_text(&self, text: &str) -> Result<(), LocatorError>

Type text character by character.

Errors

Returns an error if the element cannot be focused or keys cannot be dispatched.

pub async fn hover(&self) -> Result<(), LocatorError>

Hover over the element.

Errors

Returns an error if the element cannot be found or the mouse event fails.

pub async fn text_content(&self) -> Result<Option<String>, LocatorError>

Get the text content of the element.

Errors

Returns an error if the element cannot be queried.

pub async fn is_visible(&self) -> Result<bool, LocatorError>

Check if the element is visible.

Errors

Returns an error if the element cannot be queried.

pub async fn count(&self) -> Result<usize, LocatorError>

Count matching elements.

Errors

Returns an error if the elements cannot be queried.

Trait Implementations

impl<'a> Clone for FrameElementLocator<'a>

fn clone(&self) -> FrameElementLocator<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for FrameElementLocator<'a>

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

Formats the value using the given formatter.

impl<'a> From<FrameRoleLocatorBuilder<'a>> for FrameElementLocator<'a>

fn from(builder: FrameRoleLocatorBuilder<'a>) -> Self

Converts to this type from the input type.