mix excessibility (Excessibility v0.14.0)

View Source

Runs axe-core accessibility checks on HTML snapshots.

Usage

With no arguments, checks ALL existing snapshots:

mix excessibility

With arguments, runs tests first then checks NEW snapshots only:

# Run a test file
mix excessibility test/my_app_web/live/page_live_test.exs

# Run a specific test by line number
mix excessibility test/my_app_web/live/page_live_test.exs:42

# Run tests with a tag
mix excessibility --only a11y

# Run a describe block
mix excessibility test/my_test.exs:10

Configuration

  • :axe_disable_rules - List of axe rule IDs to disable (default: [])
  • :excessibility_output_path - Base directory for snapshots (default: "test/excessibility")
  • :cross_snapshot_enabled? - Diff consecutive snapshots of the same test to flag content that changed without an aria-live region (default: true). Only fires on snapshots that carry capture metadata.

Prerequisites

Run mix excessibility.install first to install axe-core and Playwright via npm.