Advanced element query interface for the thirtyfour crate.
This crate is experimental and expected to have breaking changes often.
With the new query interface you can do things like:
rust
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:
rust
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. This will never return an empty Vec. If either first() or all()
don't match anything, you'll get WebDriverError::NoSuchElement instead.
The error message will show the selectors used.
To set up default polling for all elements, do this: ```rust // Disable implicit timeout in order to use new query interface. driver.setimplicitwait_timeout(Duration::new(0, 0)).await?;
let poller = ElementPoller::Time(Duration::new(20, 0), Duration::frommillis(500)); driver.configmut().set("ElementPoller", poller)?; ```
Other ElementPoller options are also available, such as NoWait and NumTries.
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