integrate with nuxt/test-utils for testing

[danielroe]

Describe the feature

it might be nice to automatically scan as part of the test suite (or expose utilities/assertions that could be used)

it might be possible to use axe directly of course

Additional information

• Would you be willing to help implement this feature?
• Could this feature be implemented as a module?

Final checks

• Read the contribution guide.
• Check existing discussions and issues.

[timdamen]

PR #210 introduces reusable utilities that can serve as a foundation for test-utils integration.

Reusable code from PR #210:

src/runtime/server/utils/axe-server.ts - Server-side axe-core runner:

export async function runAxeOnHtml(
  html: string,
  route: string,
  options: AxeServerOptions
): Promise<A11yViolation[]>

Potential test-utils API (building on PR #210):

// Could be exported from @nuxt/a11y/test-utils
import { runAxeOnHtml } from '@nuxt/a11y/server'

// In component/unit tests:
const html = wrapper.html()
const violations = await runAxeOnHtml(html, '/test-route', {})
expect(violations).toHaveLength(0)

// Or wrapped as a Vitest matcher:
expect(element).toHaveNoA11yViolations()