Files
clean-architecture-frontend…/tests/e2e/reference-form.spec.ts
DongHyeonka 855d22ac1b fix(i18n): 화면 문구 literal 검사를 ESLint 선택자로 옮긴다 (0929/08-02)
문제: `check:i18n`은 화면 파일 전체에 `/[가-힣]/`를 돌린다. 한국어 주석
한 줄에 실패하고, 영어 JSX 문구와 영어 접근성 이름은 통과한다. 샘플
화면에도 영어 literal이 이미 있었다(목록 h1 "Reference feature",
`limit {n}`, 목록 aria-label, 상세 "DetailPage"·"Resource ID"·"Created",
폼·상태 eyebrow). ko-KR 사용자에게 영어 문구와 스크린리더 이름이 섞인다.

고른 방법: (B) 문구 literal 검사를 ESLint `no-restricted-syntax` 선택자로
옮긴다(`eslint.config.ts`의 `screenTextSelectors`).
- 대상: 글자(`\p{L}`)가 든 `JSXText`, 표시·접근성 속성(`aria-label`,
  `aria-description`, `aria-roledescription`, `aria-valuetext`,
  `aria-placeholder`, `title`, `placeholder`, `alt`, `label`)의 문자열
  literal, 그리고 `{"..."}` 형태의 같은 literal. 주석은 AST에 없어 빠진다.
  구두점·숫자만 있는 문구는 통과한다.
- 범위(4.3절 "화면 코드"): 지난 `check:i18n`과 같은 폴더다. 공통 UI
  폴더와 `src/features/*/presentation`. 컴포넌트 갤러리
  `src/presentation/examples`는 지금처럼 뺀다. stories(`*.stories.tsx`)는
  workshop 코드라 뺀다. 테스트는 이 폴더 밖이라 대상이 아니다.
- 이 항목은 일반 `no-restricted-syntax` 목록을 대체하므로 FE-OC-019
  선택자(raw HTML, script 생성)를 함께 싣는다.
- `check:i18n`에는 catalog parity와 raw backend 메시지 검사만 남긴다.
  raw HTML은 원래 전역 FE-OC-019 ESLint 규칙이 거절한다.
- `check:i18n:fixture`는 ESLint Node API로 같은 규칙을 fixture 트리에도
  돌린다. forbidden 파일은 하나하나 거절돼야 하고(아니면 종료 코드 2),
  새 `tests/fixtures/i18n/allowed` 트리(한국어 주석, 구두점, catalog
  문구)는 통과해야 한다(거절되면 종료 코드 2). 게이트 기대값(종료 1,
  "I18n contract failed:")은 그대로다.
- fixture 추가: allowed `korean-comment.tsx`, forbidden
  `english-jsx-text.tsx`, `english-accessible-name.tsx`.
- 샘플의 영어 literal 11곳을 catalog로 옮겼다. 새 키 10개
  (`reference.list.title`·`filterLimit`·`filterTags`·`resources`,
  `reference.detail.eyebrow`·`titlePending`·`resourceId`·`createdAt`,
  `reference.form.eyebrow`, `reference.status.eyebrow`). en-US 값은
  예전 영어 문구 그대로라 en-US 화면은 바뀌지 않는다. ko-KR 화면은 한국어가
  된다.

버린 대안:
- (A) 현 상태: 두 제품이 각각 막히거나 스크립트를 고쳤다.
- (C) "행동·상태 문구"만 정규식으로 고르는 제품 정책: 한국어 문장 목록에
  기대 영어를 못 잡고, 템플릿 기본값으로 쓰기에 제품 특화다.
ESLint 설정은 제품이 자기 규칙으로 덮어쓸 수 있는 자리다(한 locale 제품,
고유명사 허용).

위험·한계:
- 식 안에서 만든 문구는 보지 못한다. template literal, 삼항식, 객체
  prop(`heading.title` 같은 것)이 그렇다. 샘플의 이런 문구는 손으로
  옮겼고, `reference-page.test.tsx`가 ko-KR main 영역을 catalog·데이터
  밖 라틴 문자로 검사해 그 빈 곳을 샘플에서만 막는다.
- 고유명사·브랜드 이름도 걸린다. 제품이 선택자를 덮어쓰거나 그 줄에
  `eslint-disable-next-line`을 쓴다.
- ko-KR route 제목(`route.REFERENCE_RESOURCE_*`)은 catalog 안의 영어라
  그대로 뒀다(라우트 제목 정리는 0929/08-06 몫).
- `tests/e2e/reference-form.spec.ts`의 ko-KR 목록 h1 기대값을 "참조
  기능"으로 바꿨다. e2e는 이 worktree에서 돌리지 않았다(webServer가
  pnpm build를 부른다).
- 시각 골든(`tests/visual`)은 /examples/ui·states·platform만 찍는다.
  샘플 화면과 nav 문구는 바뀌지 않아 골든 영향이 없다고 본다(미실행).

검증:
- RED(수정 전):
  - E1 한글 주석 변이: `node scripts/check-i18n.ts` -> "hardcoded common
    user-facing locale literal in .../reference-resource-status-page.tsx",
    exit 1
  - E1b 영어 JSX 문구 변이: `check-i18n.ts` PASS exit 0, `eslint` exit 0
  - `check-i18n.ts --fixture` -> "I18n fixture was not rejected:
    english-accessible-name.tsx, english-jsx-text.tsx", exit 2
  - 새 ko-KR main 테스트: "limit 5 · tags ..." 가 남아 실패
- GREEN(수정 후):
  - E1 변이: `check-i18n.ts` PASS, `eslint` exit 0
  - E1b 변이: `eslint` -> 42:13 no-restricted-syntax, exit 1
  - `check-i18n.ts` PASS(224 keys), `--fixture` -> forbidden 7개 모두
    거절, "I18n contract failed:", exit 1. allowed에 영어 문구를 넣으면
    "I18n allowed fixture was rejected", exit 2
  - ko-KR main 테스트 통과
- `npx eslint src scripts tests recipes .storybook ... --max-warnings=0`
  통과, app·test·node 타입 검사 통과
- vitest: tests/unit + tests/component 209 files 2725 tests,
  tests/features 등 25 files 141 tests 통과
- `check-registries.ts` PASS, `check-ci-contract.ts` PASS,
  `verify-documentation-readiness.ts` PASS_SCOPED

Refs: docs/reviews/2026-09-29-maturity-review/08-presentation.md 08-02, 4.3
2026-11-03 00:54:18 +09:00

151 lines
5.7 KiB
TypeScript

import AxeBuilder from "@axe-core/playwright";
import type { Page } from "@playwright/test";
import { expect, test } from "../support/browser/strict-browser-test.ts";
async function openReferenceForm(page: Page) {
await page.goto("/examples/reference-resources/new");
await page.getByRole("button", { name: "로그인 시작" }).click();
await expect(
page.getByRole("heading", { name: "Reference resource 만들기" }),
).toBeVisible();
}
test("validates a reference form and focuses the first invalid field", async ({
page,
}) => {
await openReferenceForm(page);
await page.getByRole("button", { name: "저장" }).click();
const firstField = page.getByRole("textbox", { name: /새 항목 이름/ });
await expect(firstField).toBeFocused();
await expect(firstField).toHaveAttribute("aria-invalid", "true");
await expect(page.getByRole("alert")).toContainText("입력 내용을 확인해 주세요.");
});
test("guards dirty cancellation and restores focus when writing continues", async ({
page,
}) => {
await openReferenceForm(page);
await page
.getByRole("textbox", { name: /새 항목 이름/ })
.fill("Unsaved reference");
const cancel = page.getByRole("button", { name: "취소" });
await cancel.click();
await expect(
page.getByRole("dialog", { name: "저장하지 않은 변경이 있습니다." }),
).toBeVisible();
await page.getByRole("button", { name: "계속 작성" }).click();
await expect(cancel).toBeFocused();
await expect(page).toHaveURL(/\/examples\/reference-resources\/new$/);
});
test("keeps the form template within a 320px viewport", async ({ page }) => {
await page.setViewportSize({ width: 320, height: 720 });
await openReferenceForm(page);
const viewport = await page.evaluate(() => ({
clientWidth: document.documentElement.clientWidth,
scrollWidth: document.documentElement.scrollWidth,
}));
expect(viewport.scrollWidth).toBeLessThanOrEqual(viewport.clientWidth);
});
// 08-04. Feature screens take their words from the catalog. This lives with
// the sample's specs so removing the sample removes it too.
test("renders the reference screens without Korean copy in en-US", async ({
page,
}) => {
await page.route("http://localhost:8080/api/reference-resources?*", (route) =>
route.fulfill({
json: [
{
id: "browser-reference",
name: "Browser reference",
createdAt: "2026-07-26T00:00:00.000Z",
},
],
}),
);
await page.goto("/examples/reference-resources");
await page.getByRole("button", { name: "로그인 시작" }).click();
await expect(page.getByRole("link", { name: "Browser reference" })).toBeVisible();
await page.getByRole("combobox", { name: "언어" }).selectOption("en-US");
const main = page.getByRole("main");
await expect(main.getByRole("status")).toHaveText("Total items: 1");
await expect(main).not.toContainText(/[가-힣]/);
await main.getByRole("button", { name: "Create item" }).click();
await expect(main.getByRole("button", { name: "Save" })).toBeVisible();
await expect(main).not.toContainText(/[가-힣]/);
});
const LIST_PATH = "/examples/reference-resources";
const LIST_API = "http://localhost:8080/api/reference-resources?*";
const BROWSER_REFERENCE = {
id: "browser-reference",
name: "Browser reference",
createdAt: "2026-07-26T00:00:00.000Z",
};
async function signInAt(page: Page, path: string, heading: string) {
await page.goto(path);
await page.getByRole("button", { name: "로그인 시작" }).click();
await expect(page.getByRole("heading", { level: 1 })).toHaveText(heading);
}
async function expectNoBlockingViolations(page: Page) {
const results = await new AxeBuilder({ page })
.withTags(["wcag2a", "wcag2aa", "wcag21a", "wcag21aa"])
.analyze();
expect(
results.violations.filter((violation) =>
["critical", "serious"].includes(violation.impact ?? ""),
),
).toEqual([]);
}
// 08-05. The protected reference screens are scanned signed in and in each
// state they can show. The state must be on screen before axe runs.
for (const [state, payload, visible] of [
["success", [BROWSER_REFERENCE], "Browser reference"],
["empty", [], "표시할 항목이 없습니다."],
// A 200 that breaks the response schema: a 5xx would also log a console
// error, which the strict fixture rejects on its own.
["error", [{ wrong: true }], "서버 응답 데이터가 현재 화면과 맞지 않습니다."],
] as const) {
test(`@a11y reference list ${state} state has no blocking violations`, async ({
page,
}) => {
await page.route(LIST_API, (route) => route.fulfill({ json: payload }));
await signInAt(page, LIST_PATH, "참조 기능");
await expect(page.getByRole("main")).toContainText(visible);
await expectNoBlockingViolations(page);
});
}
test("@a11y reference detail has no blocking violations", async ({ page }) => {
await page.route(
"http://localhost:8080/api/reference-resources/browser-reference",
(route) => route.fulfill({ json: BROWSER_REFERENCE }),
);
await signInAt(page, `${LIST_PATH}/items/browser-reference`, "Browser reference");
await expectNoBlockingViolations(page);
});
test("@a11y reference form with submit errors has no blocking violations", async ({
page,
}) => {
await signInAt(page, `${LIST_PATH}/new`, "Reference resource 만들기");
await page.getByRole("button", { name: "저장" }).click();
await expect(page.getByRole("alert")).toContainText("입력 내용을 확인해 주세요.");
await expectNoBlockingViolations(page);
});
test("@a11y reference status page has no blocking violations", async ({
page,
}) => {
await signInAt(page, `${LIST_PATH}/status`, "잠시 사용할 수 없습니다.");
await expectNoBlockingViolations(page);
});