Struct thirtyfour::WebElement

pub struct WebElement {
    pub element_id: ElementId,
    // some fields omitted
}

The WebElement struct encapsulates a single element on a page.

WebElement structs are generally not constructed manually, but rather they are returned from a 'find_element()' operation using a WebDriver.

Example:

let elem = driver.find_element(By::Name("input-result")).await?;

You can also search for a child element of another element as follows:

let elem = driver.find_element(By::Css("div[data-section='section-buttons']")).await?;
let child_elem = elem.find_element(By::Tag("button")).await?;

Elements can be clicked using the click() method, and you can send input to an element using the send_keys() method.

Fields

element_id: ElementId

Methods

impl<'a> WebElement

pub fn new(
    conn: Arc<RemoteConnectionAsync>,
    session_id: SessionId,
    element_id: ElementId
) -> Self

Create a new WebElement struct.

Typically you would not call this directly. WebElement structs are usually constructed by calling one of the find_element*() methods either on WebDriver or another WebElement.

pub async fn rect<'_>(&'_ self) -> WebDriverResult<ElementRect>

Get the bounding rectangle for this WebElement.

pub async fn tag_name<'_>(&'_ self) -> WebDriverResult<String>

Get the tag name for this WebElement.

pub async fn text<'_>(&'_ self) -> WebDriverResult<String>

Get the text contents for this WebElement.

pub async fn click<'_>(&'_ self) -> WebDriverResult<()>

Click the WebElement.

pub async fn clear<'_>(&'_ self) -> WebDriverResult<()>

Clear the WebElement contents.

pub async fn get_property<'_, '_>(
    &'_ self,
    name: &'_ str
) -> WebDriverResult<String>

Get the specified property.

pub async fn get_attribute<'_, '_>(
    &'_ self,
    name: &'_ str
) -> WebDriverResult<String>

Get the specified attribute.

pub async fn get_css_property<'_, '_>(
    &'_ self,
    name: &'_ str
) -> WebDriverResult<String>

Get the specified CSS property.

pub async fn is_selected<'_>(&'_ self) -> WebDriverResult<bool>

Return true if the WebElement is currently selected, otherwise false.

pub async fn is_enabled<'_>(&'_ self) -> WebDriverResult<bool>

Return true if the WebElement is currently enabled, otherwise false.

pub async fn find_element<'_>(
    &'_ self,
    by: By<'a>
) -> WebDriverResult<WebElement>

Search for a child element of this WebElement using the specified selector.

Example:

let elem = driver.find_element(By::Css("div[data-section='section-buttons']")).await?;
let child_elem = elem.find_element(By::Tag("button")).await?;

pub async fn find_elements<'_>(
    &'_ self,
    by: By<'a>
) -> WebDriverResult<Vec<WebElement>>

Search for all child elements of this WebElement that match the specified selector.

Example:

let elem = driver.find_element(By::Css("div[data-section='section-buttons']")).await?;
let child_elems = elem.find_elements(By::Tag("button")).await?;
for child_elem in child_elems {
    assert_eq!(child_elem.tag_name().await?, "button");
}

pub async fn send_keys<'_, S>(&'_ self, keys: S) -> WebDriverResult<()> where
    S: Into<TypingData>, 

Send the specified input.

Example:

You can specify anything that implements Into<TypingData>. This includes &str and String.

elem.send_keys("selenium").await?;

You can also send special key combinations like this:

use thirtyfour::{Keys, TypingData};
elem.send_keys("selenium").await?;
elem.send_keys(Keys::Control + "a").await?;
elem.send_keys(TypingData::from("thirtyfour") + Keys::Enter).await?;

pub async fn screenshot_as_base64<'_>(&'_ self) -> WebDriverResult<String>

Take a screenshot of this WebElement and return it as a base64-encoded String.

pub async fn screenshot_as_png<'_>(&'_ self) -> WebDriverResult<Vec<u8>>

Take a screenshot of this WebElement and return it as PNG bytes.

pub async fn screenshot<'_, '_>(&'_ self, path: &'_ Path) -> WebDriverResult<()>

Take a screenshot of this WebElement and write it to the specified filename.

Trait Implementations

impl Clone for WebElement

fn clone(&self) -> WebElement

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for WebElement

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

Formats the value using the given formatter.

impl Display for WebElement

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

Formats the value using the given formatter.

impl Serialize for WebElement

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.