Enum By 

pub enum By {
    Css(String),
    XPath(String),
    Text(String),
    PartialText(String),
    Id(String),
    Tag(String),
    Name(String),
    Class(String),
    LinkText(String),
    PartialLinkText(String),
}

Element locator strategy (like Selenium’s By).

Supports multiple strategies for finding elements in the DOM.

Variants

Css(String)

CSS selector (most common).

Example

By::Css("#login-button")
By::Css("button.primary")
By::Css("[data-testid='submit']")

XPath(String)

XPath expression.

Example

By::XPath("//button[@type='submit']")
By::XPath("//div[contains(@class, 'modal')]")
By::XPath("//a[text()='Login']")

Text(String)

Exact text content match.

Finds element where textContent.trim() === value.

Example

By::Text("Submit")
By::Text("Click here to continue")

PartialText(String)

Partial text content match.

Finds element where textContent.includes(value).

Example

By::PartialText("Submit")
By::PartialText("continue")

Id(String)

Element ID (shorthand for #id CSS selector).

Example

By::Id("username")  // equivalent to By::Css("#username")

Tag(String)

Tag name.

Example

By::Tag("button")
By::Tag("input")

Name(String)

Name attribute.

Example

By::Name("email")  // equivalent to By::Css("[name='email']")

Class(String)

Class name (single class).

Example

By::Class("btn-primary")  // equivalent to By::Css(".btn-primary")

LinkText(String)

Link text (for <a> elements).

Example

By::LinkText("Home")

PartialLinkText(String)

Partial link text (for <a> elements).

Example

By::PartialLinkText("Read more")

Implementations

impl By

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

Creates a CSS selector.

pub fn xpath(expr: impl Into<String>) -> Self

Creates an XPath selector.

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

Creates a text content selector.

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

Creates a partial text content selector.

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

Creates an ID selector.

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

Creates a tag name selector.

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

Creates a name attribute selector.

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

Creates a class name selector.

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

Creates a link text selector.

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

Creates a partial link text selector.

pub fn strategy(&self) -> &'static str

Returns the strategy name for the protocol.

pub fn value(&self) -> &str

Returns the selector value.

Trait Implementations

impl Clone for By

fn clone(&self) -> By

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for By

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for By

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&str> for By

fn from(s: &str) -> Self

Converts a string to CSS selector (default).

impl From<String> for By

fn from(s: String) -> Self

Converts a string to CSS selector (default).

impl PartialEq for By

fn eq(&self, other: &By) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for By

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for By

impl StructuralPartialEq for By