Struct thirtyfour_query::ElementQuery

pub struct ElementQuery<'a> { /* fields omitted */ }

High-level interface for performing powerful element queries using a builder pattern.

Example:

// Disable implicit timeout in order to use new query interface.
driver.set_implicit_wait_timeout(Duration::new(0, 0)).await?;

let poller = ElementPoller::TimeoutWithInterval(Duration::new(10, 0), Duration::from_millis(500));
driver.config_mut().set("ElementPoller", poller)?;

driver.get("http://webappdemo").await?;

let elem = driver.query(By::Id("button1")).first().await?;

Implementations

impl<'a> ElementQuery<'a>

pub fn desc(self, description: &str) -> Self

Provide a name that will be included in the error message if the query was not successful. This is useful for providing more context about this particular query.

pub fn ignore_errors(self, ignore: bool) -> Self

By default a query will ignore any errors that occur while polling for the desired element(s). However, this behaviour can be modified so that the waiter will return early if an error is returned from thirtyfour.

pub fn with_poller(self, poller: ElementPoller) -> Self

Use the specified ElementPoller for this ElementQuery. This will not affect the default ElementPoller used for other queries.

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

Force this ElementQuery to wait for the specified timeout, polling once after each interval. This will override the poller for this ElementQuery only.

pub fn nowait(self) -> Self

Force this ElementQuery to not wait for the specified condition(s). This will override the poller for this ElementQuery only.

pub fn or(self, by: By<'a>) -> Self

Add a new selector to this ElementQuery. All conditions specified after this selector (up until the next or() method) will apply to this selector.

pub async fn exists(&self) -> WebDriverResult<bool>

Return true if an element matches any selector, otherwise false.

pub async fn not_exists(&self) -> WebDriverResult<bool>

Return true if no element matches any selector, otherwise false.

pub async fn first(&self) -> WebDriverResult<WebElement<'a>>

Return only the first WebElement that matches any selector (including all of the filters for that selector).

pub async fn all(&self) -> WebDriverResult<Vec<WebElement<'a>>>

Return all WebElements that match any one selector (including all of the filters for that selector).

Returns an empty Vec if no elements match.

pub async fn all_required(&self) -> WebDriverResult<Vec<WebElement<'a>>>

Return all WebElements that match any one selector (including all of the filters for that selector).

Returns Err(WebDriverError::NoSuchElement) if no elements match.

pub fn with_filter(self, f: ElementPredicate) -> Self

Add the specified ElementPredicate to the last selector.

pub fn with_single_selector(self) -> Self

Set the previous selector to only return the first matched element. WARNING: Use with caution! This can result in (slightly) faster lookups, but will probably break any filters on this selector.

If you are simply want to get the first element after filtering from a list, use the first() method instead.

pub fn and_enabled(self) -> Self

Only match elements that are enabled.

pub fn and_not_enabled(self) -> Self

Only match elements that are NOT enabled.

pub fn and_selected(self) -> Self

Only match elements that are selected.

pub fn and_not_selected(self) -> Self

Only match elements that are NOT selected.

pub fn and_displayed(self) -> Self

Only match elements that are displayed.

pub fn and_not_displayed(self) -> Self

Only match elements that are NOT displayed.

pub fn and_clickable(self) -> Self

Only match elements that are clickable.

pub fn and_not_clickable(self) -> Self

Only match elements that are NOT clickable.

pub fn with_text<N>(self, text: N) -> Self where
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that have the specified text. See the Needle documentation for more details on text matching rules.

pub fn without_text<N>(self, text: N) -> Self where
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that do not have the specified text. See the Needle documentation for more details on text matching rules.

pub fn with_id<N>(self, id: N) -> Self where
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that have the specified id. See the Needle documentation for more details on text matching rules.

pub fn without_id<N>(self, id: N) -> Self where
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that do not have the specified id. See the Needle documentation for more details on text matching rules.

pub fn with_class<N>(self, class_name: N) -> Self where
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that contain the specified class name. See the Needle documentation for more details on text matching rules.

pub fn without_class<N>(self, class_name: N) -> Self where
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that do not contain the specified class name. See the Needle documentation for more details on text matching rules.

pub fn with_tag<N>(self, tag_name: N) -> Self where
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that have the specified tag. See the Needle documentation for more details on text matching rules.

pub fn without_tag<N>(self, tag_name: N) -> Self where
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that do not have the specified tag. See the Needle documentation for more details on text matching rules.

pub fn with_value<N>(self, value: N) -> Self where
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that have the specified value. See the Needle documentation for more details on text matching rules.

pub fn without_value<N>(self, value: N) -> Self where
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that do not have the specified value. See the Needle documentation for more details on text matching rules.

pub fn with_attribute<S, N>(self, attribute_name: S, value: N) -> Self where
    S: Into<String>,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that have the specified attribute with the specified value. See the Needle documentation for more details on text matching rules.

pub fn without_attribute<S, N>(self, attribute_name: S, value: N) -> Self where
    S: Into<String>,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that do not have the specified attribute with the specified value. See the Needle documentation for more details on text matching rules.

pub fn with_attributes<S, N>(self, desired_attributes: &[(S, N)]) -> Self where
    S: Into<String> + Clone,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that have all of the specified attributes with the specified values. See the Needle documentation for more details on text matching rules.

pub fn without_attributes<S, N>(self, desired_attributes: &[(S, N)]) -> Self where
    S: Into<String> + Clone,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that do not have any of the specified attributes with the specified values. See the Needle documentation for more details on text matching rules.

pub fn with_property<S, N>(self, property_name: S, value: N) -> Self where
    S: Into<String>,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that have the specified property with the specified value. See the Needle documentation for more details on text matching rules.

pub fn without_property<S, N>(self, property_name: S, value: N) -> Self where
    S: Into<String>,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that do not have the specified property with the specified value. See the Needle documentation for more details on text matching rules.

pub fn with_properties<S, N>(self, desired_properties: &[(S, N)]) -> Self where
    S: Into<String> + Clone,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that have all of the specified properties with the specified value. See the Needle documentation for more details on text matching rules.

pub fn without_properties<S, N>(self, desired_properties: &[(S, N)]) -> Self where
    S: Into<String> + Clone,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that do not have any of the specified properties with the specified value. See the Needle documentation for more details on text matching rules.

pub fn with_css_property<S, N>(self, css_property_name: S, value: N) -> Self where
    S: Into<String>,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that have the specified CSS property with the specified value. See the Needle documentation for more details on text matching rules.

pub fn without_css_property<S, N>(self, css_property_name: S, value: N) -> Self where
    S: Into<String>,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that do not have the specified CSS property with the specified value. See the Needle documentation for more details on text matching rules.

pub fn with_css_properties<S, N>(
    self,
    desired_css_properties: &[(S, N)]
) -> Self where
    S: Into<String> + Clone,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that have all of the specified CSS properties with the specified values. See the Needle documentation for more details on text matching rules.

pub fn without_css_properties<S, N>(
    self,
    desired_css_properties: &[(S, N)]
) -> Self where
    S: Into<String> + Clone,
    N: Needle + Clone + Send + Sync + 'static, 

Only match elements that do not have any of the specified CSS properties with the specified values. See the Needle documentation for more details on text matching rules.