Testing

Structure

test/                         Unit tests (no browser)
integration_test/cases/       Integration tests (all drivers)
bench/                        Load tests + benchmarks

Drivers

Running tests

# Unit tests
mix test

# Integration tests (pick a driver)
mix test.chrome            # Chrome via CDP (default, recommended)
mix test.chrome.bidi       # Chrome via WebDriver BiDi
mix test.live_view         # LiveView driver (no browser needed)

# All drivers sequentially
mix test.all

# Benchmarks and load tests
mix test.bench

# Run a specific test file
WALLABIDI_DRIVER=chrome_cdp mix test integration_test/cases/browser/find_test.exs --no-start

# Run with low concurrency (avoids Chrome process exhaustion)
WALLABIDI_DRIVER=chrome_cdp mix test --no-start --max-cases 2

Tags

Tests use tags to declare what infrastructure they need:

Tests without tags run on all drivers.

Test organization

integration_test/cases/browser/

Shared tests that run on every driver. Most tests live here. They use SessionCase which creates a session and visits a page automatically.

integration_test/cases/chrome/

Chrome-specific tests (tagged @moduletag :browser): push-based finding, shared connection, LiveView await/patch, capabilities.

integration_test/cases/live_view/

LiveView-only tests (tagged @moduletag :live_view_only): feature macro routing verification.

bench/

Not run in CI. Load tests verify throughput under concurrent sessions. Timing benchmarks compare per-operation latency across drivers.

Writing tests

Use SessionCase for most tests:

defmodule MyTest do
  use Wallabidi.Integration.SessionCase, async: true

  test "find an element", %{session: session} do
    session
    |> visit("page_1.html")
    |> find(Query.css("h1"))
  end
end

For tests that need Chrome, add @moduletag :browser. For LiveView-only tests, add @moduletag :live_view_only.

Debugging

# Run one test with verbose output
WALLABIDI_DRIVER=chrome_cdp mix test integration_test/cases/browser/click_test.exs:54 \
  --no-start --max-cases 1 --timeout 60000

# Per-operation timing benchmark (2>/dev/null suppresses Chrome's stderr noise)
mix test.bench 2>/dev/null

# Kill zombie Chrome processes
pkill -9 -f "Google Chrome for Testing"