import AxeBuilder from "@axe-core/playwright"; import { recordA11yDataState } from "../../scripts/lib/a11y-data-state.ts"; import { expect, test, type Page } from "../support/browser/strict-browser-test.ts"; import { ROUTE_REGISTRY } from "../../src/features/installed-feature-contracts.ts"; import { COMPOSED_CONTRACT_CONTRIBUTIONS } from "../../src/features/loaded-feature-runtimes.ts"; import type { RouteDefinition } from "../../src/contracts/routes.ts"; import { KO_MESSAGES } from "../../src/presentation/i18n/catalog.ts"; import { answerInstalledApiRequest, type InstalledApiAnswer, } from "./support/installed-api-answers.ts"; const WCAG_TAGS = ["wcag2a", "wcag2aa", "wcag21a", "wcag21aa"]; const SIGN_IN_TITLE = KO_MESSAGES["route.auth.required.title"]; const CATALOG = KO_MESSAGES as Readonly>; async function blockingViolations(page: Page) { const results = await new AxeBuilder({ page }).withTags(WCAG_TAGS).analyze(); return results.violations.filter((violation) => ["critical", "serious"].includes(violation.impact ?? ""), ); } // 08-05/11-02. The app shell draws `main` before the route chunk arrives, so // axe waits for the route's own h1. A public route's h1 is its catalog title. // A protected route is scanned after the demo sign-in, never on the sign-in // prompt; the feature's own spec pins its exact headings and states. // Widened: without an installed feature every route is public, and the // `session-required` branch must still typecheck (sample removal). const ROUTES: readonly RouteDefinition[] = Object.values(ROUTE_REGISTRY); // 1103/16-03. Every path parameter gets one value: a feature with its own // parameter names needs no edit here. const PATH_PARAMETER_VALUE = "a11y-1"; const API_ORIGIN = "http://localhost:8080"; for (const definition of ROUTES) { const route = definition.path === "*" ? "/not-found" : definition.path.replace(/:[A-Za-z][A-Za-z0-9_]*/gu, PATH_PARAMETER_VALUE); test(`@a11y ${route} has no critical or serious axe violations`, async ({ page, }) => { const heading = page.getByRole("heading", { level: 1 }); if (definition.access === "session-required") { // 1103/11-01. Feature data is not this spec's subject: a list read gets // an empty list in the frame its descriptor declares, so the page is // scanned in its empty state, not on a response-shape error. const answers: InstalledApiAnswer[] = []; await page.route(`${API_ORIGIN}/**`, (request) => { const answer = answerInstalledApiRequest( COMPOSED_CONTRACT_CONTRIBUTIONS, request.request().method(), new URL(request.request().url()).pathname, ); answers.push(answer); return answer.kind === "unanswerable" ? request.fulfill({ status: 501, body: answer.reason ?? answer.request }) : request.fulfill({ json: answer.body }); }); await page.goto(route); await expect(heading).toHaveText(SIGN_IN_TITLE); await page.getByRole("button", { name: "로그인 시작" }).click(); await expect(heading).toBeVisible(); await expect(heading).not.toHaveText(SIGN_IN_TITLE); await expect(page.locator("[aria-busy='true']")).toHaveCount(0); expect( answers.filter((answer) => answer.kind === "unanswerable"), "requests no installed list or single-resource read answers", ).toEqual([]); const singleResourceReads = answers.flatMap((answer) => answer.kind === "single-resource" ? [answer.operationId] : [], ); if (singleResourceReads.length === 0) { // A shape the page does not read fails here, before axe passes it. await expect(page.getByRole("alert")).toHaveCount(0); await recordA11yDataState(definition.routeId, null); } else { // No generic body answers a read of one resource: a detail page is // scanned in its failure state. 1103/11-01. a11y.json then lists it // under `notChecked`, not as passed. const reason = `scanned on its failure state only: ${singleResourceReads.join(", ")} reads one resource`; test.info().annotations.push({ type: "a11y-data-state", description: reason }); await recordA11yDataState(definition.routeId, reason); } } else { await page.goto(route); const title = CATALOG[`route.${definition.routeId}.title`]; await expect(heading).toHaveText(title ?? definition.title); await recordA11yDataState(definition.routeId, null); } expect(await blockingViolations(page)).toEqual([]); }); } test("@a11y keyboard reaches the primary route action with visible focus", async ({ page, }) => { await page.goto("/"); const action = page.getByRole("link", { name: "플랫폼 구성 보기" }); await expect(action).toBeVisible(); await page.keyboard.press("Tab"); await expect(action).toBeFocused(); await expect(action).toHaveCSS("outline-style", "solid"); }); // 08-09. axe's skip-link rule is best-practice, outside WCAG_TAGS, so the only // way past the header and sidebar (WCAG 2.4.1) needs its own check. test("@a11y skip link moves keyboard focus into main", async ({ page }) => { await page.goto("/examples/ui"); await expect(page.getByRole("heading", { level: 1 })).toBeFocused(); const skipLink = page.getByRole("link", { name: "본문으로 건너뛰기" }); await skipLink.focus(); await expect(skipLink).toBeFocused(); await page.keyboard.press("Enter"); await expect .poll(() => page.evaluate( () => document.querySelector("main")?.contains(document.activeElement) ?? false, ), ) .toBe(true); }); test("@a11y reduced-motion policy disables long animation", async ({ page }) => { await page.emulateMedia({ reducedMotion: "reduce" }); await page.goto("/"); const duration = await page .locator("body") .evaluate((body) => getComputedStyle(body).animationDuration); expect(["0s", "0.00001s", "1e-05s"]).toContain(duration); }); test("@a11y opened design-system dialog has no blocking violations", async ({ page, }) => { await page.goto("/examples/ui"); await page.getByRole("button", { name: "모달 열기" }).click(); const results = await new AxeBuilder({ page }) .include(".ui-dialog") .withTags(WCAG_TAGS) .analyze(); expect( results.violations.filter((violation) => ["critical", "serious"].includes(violation.impact ?? ""), ), ).toEqual([]); });