Files
pn-new-crm/tests/e2e/smoke/20-accessibility.spec.ts
Matt a52e92ae3e test(a11y): @axe-core/playwright smoke check for major pages
Phase 4 — wires `@axe-core/playwright` into the smoke suite so any
critical/serious WCAG 2.1 A/AA violation on the main authenticated
pages fails CI.

tests/e2e/smoke/20-accessibility.spec.ts:
  Iterates 6 routes (dashboard, clients, yachts, interests, berths,
  admin/branding) — each navigates after login, waits for
  networkidle, runs AxeBuilder with WCAG2/2.1 A+AA tags, asserts no
  critical/serious violations.

  DISABLED_RULES list trims two known-noisy rules that fire on Radix
  primitives + design-pass-pending muted text:
    - tabindex  (Radix focus traps)
    - color-contrast  (muted body text, pending design pass)

  The list is intentionally small; new entries require a comment and
  an audit. Easier to widen than narrow.

Run: pnpm exec playwright test --project=smoke

No vitest impact (1298/1298 still green); the spec only runs on the
e2e playwright project so the unit suite stays fast.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 21:23:42 +02:00

60 lines
2.2 KiB
TypeScript

/**
* Accessibility smoke test — runs axe-core against the main authenticated
* pages and fails CI if a new WCAG 2.1 A/AA serious-or-critical violation
* shows up. Existing violations on third-party / shadcn primitives are
* pruned via the disableRules list, kept small and audited.
*
* Add new pages here as they're built; each entry is < 200ms in a smoke run.
*/
import { expect, test } from '@playwright/test';
import AxeBuilder from '@axe-core/playwright';
import { login } from './helpers';
const PAGES = [
{ path: '/port-nimara', label: 'Dashboard' },
{ path: '/port-nimara/clients', label: 'Clients list' },
{ path: '/port-nimara/yachts', label: 'Yachts list' },
{ path: '/port-nimara/interests', label: 'Interests list' },
{ path: '/port-nimara/berths', label: 'Berths list' },
{ path: '/port-nimara/admin/branding', label: 'Admin / Branding' },
];
// Known third-party + shadcn primitives whose violations we accept for now.
// Tightened as the design system addresses each one.
const DISABLED_RULES = [
// Radix's hidden focus traps occasionally produce "tabindex >= 0 should
// not be on a non-interactive element" — known shadcn dialog/sheet shape.
'tabindex',
// Color-contrast on muted body text — design pass pending.
'color-contrast',
];
test.describe('accessibility — smoke', () => {
test.beforeEach(async ({ page }) => {
await login(page, 'super_admin');
});
for (const { path, label } of PAGES) {
test(`${label} has no critical/serious WCAG violations`, async ({ page }) => {
await page.goto(path);
await page.waitForLoadState('networkidle');
const results = await new AxeBuilder({ page })
.withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa'])
.disableRules(DISABLED_RULES)
.analyze();
const blocking = results.violations.filter(
(v) => v.impact === 'critical' || v.impact === 'serious',
);
if (blocking.length > 0) {
const summary = blocking
.map((v) => ` - [${v.impact}] ${v.id}: ${v.help} (${v.nodes.length} occurrences)`)
.join('\n');
throw new Error(`Accessibility violations on ${path}:\n${summary}\n\nSee ${results.url}`);
}
expect(blocking).toEqual([]);
});
}
});