Testing

A Tauri app is a Rust core and a web frontend working together, so it pays to test in layers. This chapter covers Rust unit tests, frontend tests with a mocked IPC layer, and WebDriver-based end-to-end tests that drive the real app window.

Rust unit tests

A function marked #[tauri::command] is still a plain Rust function, so tests can call it directly. Even better, keep logic in pure functions and make commands a thin layer that calls them; that makes testing much easier.

// src-tauri/src/lib.rs
fn normalize_title(title: &str) -> String {
    title.trim().to_string()
}

#[tauri::command]
fn divide(a: f64, b: f64) -> Result<f64, String> {
    if b == 0.0 {
        return Err("cannot divide by zero".into());
    }
    Ok(a / b)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn trims_title() {
        assert_eq!(normalize_title("  groceries "), "groceries");
    }

    #[test]
    fn divide_by_zero_is_error() {
        assert!(divide(1.0, 0.0).is_err());
        assert_eq!(divide(9.0, 3.0), Ok(3.0));
    }
}

Run the tests from src-tauri, or pass the manifest path from the repository root.

cd src-tauri && cargo test

# or, from the repository root
cargo test --manifest-path src-tauri/Cargo.toml

To exercise commands that take State or AppHandle through the real IPC path, enable the test feature of the tauri crate and use the mock runtime in tauri::test (mock_builder, mock_context, noop_assets) to build an app without opening a window.

Frontend tests with a mocked IPC

A plain browser or jsdom has no Tauri core behind it, so invoke cannot work as is. mockIPC from @tauri-apps/api/mocks fakes command responses, letting you test UI code with Vitest or Jest. Set environment to "jsdom" in your Vitest config.

// src/greet.test.ts
import { afterEach, beforeAll, expect, test } from "vitest";
import { randomFillSync } from "node:crypto";
import { clearMocks, mockIPC } from "@tauri-apps/api/mocks";
import { invoke } from "@tauri-apps/api/core";

beforeAll(() => {
  // jsdom has no WebCrypto implementation, so provide one
  Object.defineProperty(window, "crypto", {
    value: { getRandomValues: (buffer: any) => randomFillSync(buffer) },
  });
});

// Reset mocked state between tests
afterEach(() => clearMocks());

test("mocks the greet command", async () => {
  mockIPC((cmd, args) => {
    if (cmd === "greet") return `Hello, ${(args as { name: string }).name}!`;
  });
  await expect(invoke("greet", { name: "Tauri" })).resolves.toBe("Hello, Tauri!");
});