frontend-quality-gates / merge / static checks (pull_request) Successful in 3m52s
frontend-quality-gates / merge / tests (pull_request) Failing after 15m28s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 10m56s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
접근성 자동 검사 셋이 지키는 것에 닿지 않는다. - reduced-motion e2e가 body의 animationDuration으로 브라우저 기본값 0s도 받아들인다. responsive.css의 reduced-motion 규칙을 지워도 통과한다(1112/05-08). - 예제 화면을 Storybook 갤러리로 옮기면서 화면 전체 axe 검사가 빠졌다. 기능이 없는 템플릿에서 빈·오류·로그인·권한 표면이 axe를 받지 않는다(05-04). - 제품이 WCAG 2.2 AA를 약속하는데 스캔 태그는 2.1까지다. 같은 태그 목록이 네 곳에 손으로 적혀 있다(05-05 일부). - 셸 compact drawer는 modal이고 모든 셸 route에 있는데, 라우트 수동 기록 셋과 checklist 예시가 M4를 "modal 없음"으로 채운다(05-07). 고른 방법: reduced-motion 시험은 규칙이 없을 때의 값(0s)과 규칙의 값 (0.01ms)을 함께 본다. 갤러리 두 story를 light·dark에서 화면 전체 axe로 본다. 태그는 tests/support/browser/axe-tags.ts 하나에 두고 wcag22aa를 더한다. 라우트 기록의 M4를 pending으로 바꾸고 checklist에 셸 drawer를 적는다. 수동 기록 양식에 2.4.11·2.5.8 칸을 더하는 일(05-05의 나머지)은 양식과 생성 출력이 바뀌는 일이라 이 커밋에 넣지 않았다. R9-D9(권하는 안으로 정함 (2026-11-12, 총괄))에 따라 따로 한다. 위험·한계: wcag22aa는 axe의 target-size 규칙만 더한다. 포커스 가림(2.4.11) 같은 기준은 여전히 수동이다. 검증: reduced-motion 시험이 규칙을 지운 변이에서 실패하고 원래 코드에서 통과한다. 갤러리 axe 넷과 FE-GATE-009는 desktop에서 돈다(PR 본문). Refs: 1112/05-04, 1112/05-05, 1112/05-07, 1112/05-08
151 lines
6.7 KiB
TypeScript
151 lines
6.7 KiB
TypeScript
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";
|
|
import { WCAG_AXE_TAGS } from "../support/browser/axe-tags.ts";
|
|
|
|
const WCAG_TAGS = [...WCAG_AXE_TAGS];
|
|
const SIGN_IN_TITLE = KO_MESSAGES["route.auth.required.title"];
|
|
const CATALOG = KO_MESSAGES as Readonly<Record<string, string>>;
|
|
|
|
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,
|
|
}) => {
|
|
// 1106/11-01. An earlier run's record never outlives this run, even when
|
|
// no record call below is reached. scripts/write-a11y-report.ts then
|
|
// fails on a route the descriptors say reads one resource.
|
|
await recordA11yDataState(definition.routeId, null);
|
|
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/platform");
|
|
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);
|
|
});
|
|
|
|
// 1112/05-08. The policy is the reduced-motion rule (responsive.css): every
|
|
// animation and transition becomes 0.01 ms. The browser default is 0s, so the
|
|
// check reads the rule's own value and compares it with the default, or a
|
|
// deleted rule passes.
|
|
test("@a11y reduced-motion policy disables long animation", async ({ page }) => {
|
|
const durations = () =>
|
|
page.locator("body").evaluate((body) => {
|
|
const style = getComputedStyle(body);
|
|
return [style.animationDuration, style.transitionDuration];
|
|
});
|
|
const REDUCED = ["0.00001s", "1e-05s"];
|
|
await page.goto("/");
|
|
expect(await durations()).toEqual(["0s", "0s"]);
|
|
|
|
await page.emulateMedia({ reducedMotion: "reduce" });
|
|
|
|
const [animation, transition] = await durations();
|
|
expect(REDUCED).toContain(animation);
|
|
expect(REDUCED).toContain(transition);
|
|
});
|