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>
60 lines
2.2 KiB
TypeScript
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([]);
|
|
});
|
|
}
|
|
});
|