tauri-plugin-webdriver

A W3C WebDriver implementation for Tauri applications, enabling automated testing with standard WebDriver clients like Selenium, WebdriverIO, and Playwright.

Features

• Full W3C WebDriver compliance - 47 endpoints implementing the W3C WebDriver specification
• Native platform integration - Uses native WebView APIs for reliable automation
• Zero configuration - Just add the plugin and start testing
• Standard tooling support - Works with Selenium, WebdriverIO, Playwright, and any W3C-compliant client

Supported Platforms

Installation

Warning: This plugin exposes automation capabilities via HTTP. Never include it in production builds.

Add to your Cargo.toml as a dev/test-only dependency:

[target.'cfg(debug_assertions)'.dependencies]
tauri-plugin-webdriver = "0.1"

Or use a feature flag for more control:

[features]
webdriver = ["tauri-plugin-webdriver"]

[dependencies]
tauri-plugin-webdriver = { version = "0.1", optional = true }

Usage

1. Register the plugin

Use conditional compilation to exclude the plugin from release builds:

fn main() {
    let builder = tauri::Builder::default();

    #[cfg(debug_assertions)]
    let builder = builder.plugin(tauri_plugin_webdriver::init());

    builder
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

Or with a feature flag:

fn main() {
    let builder = tauri::Builder::default();

    #[cfg(feature = "webdriver")]
    let builder = builder.plugin(tauri_plugin_webdriver::init());

    builder
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

The WebDriver server starts automatically on http://127.0.0.1:4445.

2. Connect with a WebDriver client

Python (Selenium)

from selenium import webdriver
from selenium.webdriver.common.by import By

# Connect to your Tauri app
driver = webdriver.Remote(
    command_executor="http://127.0.0.1:4445",
    options=webdriver.ChromeOptions()  # Options are accepted but not processed
)

# Interact with your app
driver.get("tauri://localhost")  # Or your app's URL
element = driver.find_element(By.CSS_SELECTOR, "#my-button")
element.click()

# Take a screenshot
driver.save_screenshot("screenshot.png")

driver.quit()

JavaScript (WebdriverIO)

const { remote } = require('webdriverio');

(async () => {
    const browser = await remote({
        hostname: '127.0.0.1',
        port: 4445,
        capabilities: {}
    });

    await browser.url('tauri://localhost');
    const button = await browser.$('#my-button');
    await button.click();

    await browser.deleteSession();
})();

Rust

use fantoccini::{ClientBuilder, Locator};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = ClientBuilder::native()
        .connect("http://127.0.0.1:4445")
        .await?;

    client.goto("tauri://localhost").await?;

    let button = client.find(Locator::Css("#my-button")).await?;
    button.click().await?;

    client.close().await?;
    Ok(())
}

W3C WebDriver Endpoints

Session Management

Timeouts

Navigation

Elements

Shadow DOM

Windows

Frames

Scripts

Cookies

Alerts

Actions

Document

Locator Strategies

The following locator strategies are supported:

Configuration

The WebDriver server runs on port 4445 by default. The server binds to 127.0.0.1 for security.

Development

# Build the plugin
cargo build

# Run clippy
cargo clippy --all-targets -- -D warnings -D clippy::pedantic

# Run the example app
cd examples/tauri-app
cargo tauri dev

License

MIT