SeleniumBase for Rust

Welcome to the SeleniumBase for Rust book. This guide explains how to build browser automation scripts, end-to-end tests, and operational tooling with seleniumbase-rs.

The crate is a Rust port of the Python SeleniumBase framework. It keeps the parts that make SeleniumBase productive—the large BaseCase API, anti-detection features, recorder, and CLI—while replacing the Python runtime with Rust’s type system, async runtime, and native distribution model.

Quickstart#

Rust 1.99 or newer and a Chromium-based browser (Chrome, Chromium or Edge) are all you need.

cargo new my_first_testcd my_first_test

[dependencies]seleniumbase-rs = { git = "https://github.com/MustCodeAl/seleniumbase-rs" }tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

use seleniumbase_rs::sb_cdp::{Browser, LaunchOptions};#[tokio::main]async fn main() -> Result<(), seleniumbase_rs::SeleniumBaseError> {    let browser = Browser::launch(LaunchOptions::builder().headless(true).build()?).await?;    let page = browser.default_page().await?;    page.goto("seleniumbase.io/simple/login").await?; // https:// is added for you    page.locator("#username").fill("demo_user").await?;    page.locator("#password").fill("secret_pass").await?;    page.locator("button").click().await?;    page.locator("h1").expect().to_contain_text("Welcome").await?;    browser.close().await?;    Ok(())}

use seleniumbase_rs::{BaseCase, BrowserConfig, DriverMode};#[tokio::main]async fn main() -> Result<(), Box<dyn std::error::Error>> {    let config = BrowserConfig::default()        .with_mode(DriverMode::Uc)        .with_headless(false);    // Starts the browser, and chromedriver if needed.    let mut sb = BaseCase::new(config).await?;    sb.open("https://seleniumbase.io/simple/login").await?;    sb.type_text("#username", "demo_user").await?;    sb.type_text("#password", "secret_pass").await?;    sb.click("#log-in").await?;    sb.assert_text_visible("Welcome!", "body").await?;    sb.quit().await?;    Ok(())}

cargo run

Who this book is for#

• Rust developers writing browser tests for the first time.
• Teams migrating from Python SeleniumBase or Selenium who want to keep a similar API while gaining compile-time guarantees.
• Automation engineers who need undetected browser execution, CDP control, or cloud artifact uploads.
• Operators who want a small native CLI (sbrs) and Docker image for CI/CD.

What you will learn#

By reading this book you will learn how to:

1. Create a Rust project, add seleniumbase-rs, and run your first test.
2. Choose between WebDriver, CDP, UC, and Playwright browser modes.
3. Use selectors, waits, assertions, and the recorder to write maintainable tests.
4. Configure runs with BrowserConfig, sbase_config.toml, and SB_* environment variables.
5. Apply anti-detection measures including fingerprints, binary patching, and engine spoofing arguments.
6. Integrate with cloud storage, Gherkin, Selenium IDE, PDF tools, charts, tours, and the sbrs CLI.
7. Operate the test suite reliably in CI/CD with tracing, Docker, and shell completions.

What is included#

• Browser modes: WebDriver, CDP, UC (Undetected Chromedriver), and an optional rustwright-based Playwright-compatible engine.
• BaseCase API: more than 200 methods for navigation, element interaction, assertions, waits, frames, windows, cookies, storage, uploads, PDF handling, HTML parsing, and more.
• Stealth stack: ChromedriverPatcher, ChromeBinaryPatcher, Fingerprint presets, StealthPolicy, and a priority-ordered EvasionProvider registry.
• Low-code tooling: JSON scenario runner, Python importer, Selenium IDE parser, Gherkin runner, and action recorder.
• Operational tooling: sbrs CLI, Commander TUI, shell completions, Docker image, SB_* environment configuration, and structured tracing output.
• Optional integrations: S3, Azure Blob Storage, Google Cloud Storage, and an MCP server, each behind a Cargo feature flag.

How to use this book#

Current status#

Every API of Python SeleniumBase 4.55.2 has a recorded status in the parity table. Development happens on MustCodeAl/seleniumbase-rs, and releases are tagged there.

The ecosystem#

Companion projects live in their own repositories and are documented on this site: see the Ecosystem page.

Build this book locally#

Install mdBook, then run from the repository root:

mdbook serve --open

mdbook build

mdbook serve --open serves the book and opens it. mdbook build builds a static copy. The built HTML is written to the book/ directory.