Struct fantoccini::Element

pub struct Element { /* fields omitted */ }

A single element on the current page.

Implementations

impl Element

pub async fn attr(
    &mut self,
    attribute: &str
) -> Result<Option<String>, CmdError>

Look up an attribute value for this element by name.

Ok(None) is returned if the element does not have the given attribute.

pub async fn prop(&mut self, prop: &str) -> Result<Option<String>, CmdError>

Look up a DOM property for this element by name.

Ok(None) is returned if the element does not have the given property.

pub async fn text(&mut self) -> Result<String, CmdError>

Retrieve the text contents of this elment.

pub async fn html(&mut self, inner: bool) -> Result<String, CmdError>

Retrieve the HTML contents of this element.

inner dictates whether the wrapping node's HTML is excluded or not. For example, take the HTML:

<div id="foo"><hr /></div>

With inner = true, <hr /> would be returned. With inner = false, <div id="foo"><hr /></div> would be returned instead.

pub async fn find(&mut self, search: Locator<'_>) -> Result<Element, CmdError>

Find the first matching descendant element.

pub async fn find_all(
    &mut self,
    search: Locator<'_>
) -> Result<Vec<Element>, CmdError>

Find all matching descendant elements.

pub async fn click(self) -> Result<Client, CmdError>

Simulate the user clicking on this element.

Note that since this may result in navigation, we give up the handle to the element.

pub async fn clear(&mut self) -> Result<(), CmdError>

Clear the value prop of this element

pub async fn send_keys(&mut self, text: &str) -> Result<(), CmdError>

Simulate the user sending keys to an element.

pub fn client(self) -> Client

Get back the Client hosting this Element.

pub async fn follow(self) -> Result<Client, CmdError>

Follow the href target of the element matching the given CSS selector without causing a click interaction.

Note that since this may result in navigation, we give up the handle to the element.

pub async fn select_by_value(self, value: &str) -> Result<Client, CmdError>

Find and click an option child element by its value attribute.

pub async fn select_by_index(self, index: usize) -> Result<Client, CmdError>

Find and click an <option> child element by its index.

This method clicks the first <option> element that is an indexth child (option:nth-of-type(index+1)). This will be the indexth <option> element if the current element is a <select>. If you use this method on an Element that is not a <select> (such as on a full <form>), it may not do what you expect if there are multiple <select> elements in the form, or if it there are stray <option> in the form.

The indexing in this method is 0-based.

pub async fn select_by_label(self, label: &str) -> Result<Client, CmdError>

Find and click an <option> element by its visible text.

The method doesn't make any escaping for the argument like it is done in python webdriver client for example. It also doesn't make any normalizations before match.

pub async fn enter_frame(self) -> Result<Client, CmdError>

Switches to the frame contained within the element.

Trait Implementations

impl Clone for Element

pub fn clone(&self) -> Element

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Element

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

Formats the value using the given formatter.

impl Serialize for Element

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

Serialize this value into the given Serde serializer.