familienarchiv/frontend/e2e/accessibility.spec.ts

import AxeBuilder from '@axe-core/playwright';
import { test, expect } from '@playwright/test';

/**
 * Automated accessibility checks using axe-core (wcag2a + wcag2aa).
 * Authenticated pages use the stored admin session from playwright.config.ts.
 * The login page test overrides to an unauthenticated context.
 *
 * Known exclusion:
 *   color-contrast — brand palette (ink-3, text-ink/60) does not meet AA contrast
 *   ratios. Requires a design review with Leonie before fixing. Tracked separately.
 */

const AUTHENTICATED_PAGES = [
	{ name: 'home', path: '/' },
	{ name: 'persons', path: '/persons' },
	{ name: 'admin', path: '/admin' }
];

function buildAxe(page: Parameters<typeof AxeBuilder>[0]['page']) {
	return new AxeBuilder({ page }).withTags(['wcag2a', 'wcag2aa']).disableRules(['color-contrast']);
}

test.describe('Accessibility — authenticated pages', () => {
	for (const { name, path } of AUTHENTICATED_PAGES) {
		test(`${name} page has no critical wcag2a/wcag2aa violations`, async ({ page }) => {
			await page.goto(path);
			await page.waitForSelector('[data-hydrated]');

			const results = await buildAxe(page).analyze();

			if (results.violations.length > 0) {
				const summary = results.violations
					.map((v) => `[${v.impact}] ${v.id}: ${v.description} (${v.nodes.length} node(s))`)
					.join('\n');
				console.log(`\nAccessibility violations on ${name}:\n${summary}`);
			}

			expect(results.violations).toEqual([]);
		});
	}
});

test.describe('Accessibility — login page', () => {
	test.use({ storageState: { cookies: [], origins: [] } });

	test('login page has no critical wcag2a/wcag2aa violations', async ({ page }) => {
		await page.goto('/login');
		await expect(page.getByLabel('Benutzername')).toBeVisible();

		const results = await buildAxe(page).analyze();

		if (results.violations.length > 0) {
			const summary = results.violations
				.map((v) => `[${v.impact}] ${v.id}: ${v.description} (${v.nodes.length} node(s))`)
				.join('\n');
			console.log(`\nAccessibility violations on login:\n${summary}`);
		}

		expect(results.violations).toEqual([]);
	});
});