15 releases (5 breaking)
0.7.0 |
|
---|---|
0.6.1 | Mar 27, 2021 |
0.6.0 | Jan 12, 2021 |
0.5.3 | Dec 29, 2020 |
0.4.2 | Nov 30, 2020 |
#11 in #geckodriver
31 downloads per month
75KB
1.5K
SLoC
Advanced element query/polling interfaces for the thirtyfour crate.
These interfaces are currently experimental and will likely be merged into
the main thirtyfour
crate once they are stable.
If you can help by testing these and providing feedback that would be appreciated.
Usage
ElementQuery
First, import the following:
use thirtyfour_query::{ElementPoller, ElementQueryable};
Next, set the default polling behaviour:
// 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(20, 0), Duration::from_millis(500));
driver.config_mut().set("ElementPoller", poller)?;
Other ElementPoller options are also available, such as NoWait and NumTriesWithInterval. These can be overridden on a per-query basis as needed.
Now, using the query interface you can do things like:
let elem_text =
driver.query(By::Css("thiswont.match")).or(By::Id("searchInput")).first().await?;
This will execute both queries once per poll iteration and return the first one that matches. You can also filter on one or both match arms like this:
driver.query(By::Css("thiswont.match")).with_text("testing")
.or(By::Id("searchInput")).with_class("search").and_not_enabled()
.first().await?;
To fetch all matching elements instead of just the first one, simply change first() to all() and you'll get a Vec instead.
ElementQuery also allows the user of custom predicates that take a &WebElement
argument
and return a WebDriverResult<bool>
.
ElementWaiter
First, import the following:
use thirtyfour_query::{ElementPoller, ElementWaitable};
Next, set the default polling behaviour (same as for ElementQuery - the same polling settings are used for both):
// 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(20, 0), Duration::from_millis(500));
driver.config_mut().set("ElementPoller", poller)?;
Now you can do things like this:
elem.wait_until().displayed().await?;
// You can optionally provide a nicer error message like this.
elem.wait_until().error("Timed out waiting for element to disappear").not_displayed().await?;
elem.wait_until().enabled().await?;
elem.wait_until().clickable().await?;
And so on. See the ElementWaiter
docs for the full list of predicates available.
ElementWaiter also allows the user of custom predicates that take a &WebElement
argument
and return a WebDriverResult<bool>
.
A range of pre-defined predicates are also supplied for convenience in the
thirtyfour_query::conditions
module.
use thirtyfour_query::conditions;
elem.wait_until().conditions(vec![
conditions::element_is_displayed(true),
conditions::element_is_clickable(true)
]).await?;
Take a look at the conditions
module for the full list of predicates available.
NOTE: Predicates require you to specify whether or not errors should be ignored.
These predicates (or your own) can also be supplied as filters to ElementQuery
.
LICENSE
This work is dual-licensed under MIT or Apache 2.0. You can choose either license if you use this work.
SPDX-License-Identifier: MIT OR Apache-2.0
Dependencies
~8–26MB
~348K SLoC