Struct Locator 

pub struct Locator { /* private fields */ }

A lazy handle to a DOM element identified by a CSS selector.

Locators are created with Page::locator and make the common “find-then-act” pattern ergonomic and composable.

Example

let browser = Browser::launch().await?;
let page = browser.new_page().await?;
page.goto("https://example.com", WaitUntil::Load).await?;

// Locator API
page.locator("button#submit").click().await?;
page.locator("input[name=q]").type_text("hello").await?;
page.locator(".result").wait_for().await?;

Implementations

impl Locator

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

Click the element identified by this locator.

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

Type text into the element identified by this locator.

pub async fn wait_for(&self) -> Result<()>

Wait until the element is present in the DOM (30 s default timeout).

pub async fn wait_for_timeout(&self, dur: Duration) -> Result<()>

Wait until the element is present with a custom timeout.

pub async fn inner_text(&self) -> Result<String>

Get the inner text of the element.

pub async fn get_attribute(&self, name: &str) -> Result<Option<String>>

Get an attribute value of the element.

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.