Screenshots and traces

    Page screenshots

    use ferridriver::options::ScreenshotOptions;

let png = page.screenshot(ScreenshotOptions::default()).await?;
std::fs::write("home.png", png).map_err(|e| e.to_string())?;

// Full page (scrolling capture)
let png = page.screenshot(ScreenshotOptions {
    full_page: Some(true),
    ..Default::default()
}).await?;

// JPEG with quality
let jpg = page.screenshot(ScreenshotOptions {
    format: Some("jpeg".into()),
    quality: Some(80),
    ..Default::default()
}).await?;

    Element screenshots

    let png = page.locator(".chart", None).screenshot().await?;

    Masking sensitive regions

    Overlay a solid color over selected elements before snapshotting:

    use ferridriver::options::ScreenshotOptions;

let png = page.screenshot(ScreenshotOptions {
    full_page: Some(true),
    mask: vec![
        page.locator(".user-email", None),
        page.locator(".credit-card", None),
    ],
    mask_color: Some("#FF00FF".into()),
    ..Default::default()
}).await?;

    Disable animations for stable captures

    use ferridriver::options::ScreenshotOptions;

let png = page.screenshot(ScreenshotOptions {
    animations: Some("disabled".into()),
    caret: Some("hide".into()),
    ..Default::default()
}).await?;

    Snapshot assertions

    Stored baseline; failures emit a diff image next to the snapshot.

    use ferridriver_test::prelude::*;
use ferridriver_test::expect::LocatorSnapshotMatchers;

#[ferritest]
async fn dashboard_snapshot(ctx: TestContext) {
    let page = ctx.page().await?;
    page.goto("https://app.example.com/dashboard", None).await?;
    expect(&page.locator(".main", None)).to_have_screenshot("dashboard.png").await?;
}

    First run writes the baseline. Subsequent runs compare. Update with:

    cargo test --test e2e -- --update-snapshots

    ARIA / accessibility snapshots

    YAML representation of the accessibility tree — readable, deterministic, and great for catching unintended a11y regressions.

    use ferridriver_test::prelude::*;
use ferridriver_test::expect::PageSnapshotMatchers;

expect(&page).to_match_aria_snapshot(r#"
- banner:
  - link "Dashboard"
  - link "Settings"
- heading "Welcome, Ada" [level=1]
- button "Sign out"
"#).await?;

    Playwright-compatible traces

    Recorded in [test].trace mode and dropped into the output directory. Open with the Playwright trace viewer:

    [test]
trace = "retain-on-failure"
    npx playwright show-trace test-results/login-flow/trace.zip

    Modes: off, on, retain-on-failure, on-first-retry.

    Manual tracing

    page.start_tracing().await?;
page.goto("https://app.example.com", None).await?;
page.locator("button.cta", None).click(None).await?;
page.stop_tracing().await?;
// Output goes to launchOptions.traces_dir

    Video recording

    Per-context:

    [test.browser.useOptions.recordVideo]
dir  = "test-results/videos"
size = { width = 1280, height = 720 }

    Modes:

    [test.video]
mode = "retain-on-failure"   # off | on | retain-on-failure

    Requires ffmpeg on PATH at runtime.

    TypeScript

    await page.screenshot({ path: 'home.png', fullPage: true });

// Locator.screenshot() returns the bytes (no path option) — write them yourself.
const chart = await page.locator('.chart').screenshot();
await Bun.write('chart.png', chart);