Rust Web自动化测试库thirtyfour_sync的使用：同步Selenium WebDriver客户端实现高效浏览器控制

概述

thirtyfour_sync是Rust的Selenium/WebDriver库，用于自动化网站UI测试。它支持完整的W3C WebDriver规范，已测试支持Chrome和Firefox浏览器，但任何兼容W3C的WebDriver都应该可以工作。

特性

• 支持所有W3C WebDriver和WebElement方法
• 直接通过WebDriver(如chromedriver)创建新浏览器会话
• 通过Selenium Standalone或Grid创建新浏览器会话
• 在drop时自动关闭浏览器会话
• 查找元素(通过所有常见选择器如Id、Class、CSS、Tag、XPath)
• 向元素发送按键，包括组合键
• 执行Javascript
• 动作链
• 获取和设置cookies
• 切换到frame/窗口/元素/alert
• 支持Shadow DOM
• 支持Alert
• 捕获/保存浏览器或单个元素的截图为PNG
• 支持Chrome DevTools协议

示例

基础示例

use thirtyfour_sync::prelude::*;

fn main() -> WebDriverResult<()> {
     let caps = DesiredCapabilities::chrome();
     let driver = WebDriver::new("http://localhost:4444", &caps)?;

     // 导航到 https://wikipedia.org
     driver.get("https://wikipedia.org")?;
     let elem_form = driver.find_element(By::Id("search-form"))?;

     // 从元素中查找元素
     let elem_text = elem_form.find_element(By::Id("searchInput"))?;

     // 输入搜索词
     elem_text.send_keys("selenium")?;

     // 点击搜索按钮
     let elem_button = elem_form.find_element(By::Css("button[type='submit']"))?;
     elem_button.click()?;

     // 查找标题以隐式等待页面加载
     driver.find_element(By::ClassName("firstHeading"))?;
     assert_eq!(driver.title()?, "Selenium - Wikipedia");
    
     // 关闭浏览器
     driver.quit()?;

     Ok(())
}

完整示例

use thirtyfour_sync::prelude::*;
use thirtyfour_sync::query::conditions;

fn main() -> WebDriverResult<()> {
    // 设置Chrome能力
    let caps = DesiredCapabilities::chrome();
    
    // 创建WebDriver实例
    let driver = WebDriver::new("http://localhost:4444", &caps)?;

    // 导航到测试页面
    driver.get("https://example.com")?;

    // 使用ElementQuery进行高级元素查询
    let elem = driver.query(By::Css("match.this"))
        .or(By::Id("orThis"))
        .first()?;
    
    // 使用ElementWaiter等待元素
    elem.wait_until().displayed()?;
    elem.wait_until().error("元素未启用").enabled()?;
    
    // 使用自定义条件
    elem.wait_until().conditions(vec![
        conditions::element_is_displayed(true),
        conditions::element_is_clickable(true)
    ])?;

    // 执行JavaScript
    driver.execute_script("alert('Hello from thirtyfour_sync!');", vec![])?;
    
    // 处理Alert
    let alert = driver.switch_to().alert()?;
    alert.accept()?;
    
    // 截屏并保存
    driver.screenshot("screenshot.png")?;
    
    // 关闭浏览器
    driver.quit()?;

    Ok(())
}

高级用法

ElementQuery

let elem_text = driver.query(By::Css("match.this")).or(By::Id("orThis")).first()?;

ElementWaiter

elem.wait_until().displayed()?;
elem.wait_until().error("等待元素消失超时").not_displayed()?;
elem.wait_until().enabled()?;
elem.wait_until().clickable()?;

测试

要运行thirtyfour_sync的测试，包括doctests：

cargo test -- --test-threads=1

许可证

这个作品采用MIT或Apache 2.0双重许可。您可以选择任一许可证来使用这个作品。

SPDX-License-Identifier: MIT OR Apache-2.0