Files
clean-architecture-frontend…/tests/unit/playwright-run-isolation.test.ts
DongHyeonka a135fa8a09 fix(test): 파일 존재로 정하던 run 격리·빌드 입력 검사를 소유자로 정한다
문제: 두 테스트가 검사 대상을 "파일이 있으면"으로 정한다.
- `playwright-run-isolation.test.ts`는 capabilities 설정이 있을 때만
  그 설정의 검사 8개를 정의한다(`existsSync`). browser-file-storage
  드릴 사본에서 33개가 25개로 줄었는데 skip 보고가 없다. 템플릿에서
  설정 이름을 바꾸고 테스트의 문자열만 놓쳐도 같이 빠진다.
- `vite-build-inputs.test.ts`는 목록 소비자 둘을 `existsSync`로 거른다.
  어느 제거 목록에도 없는 `product-feature-selection-build.test.ts`의
  이름이 바뀌어도 검사가 빈 반복으로 통과한다.
- 주석의 skip 차단 ID가 0929/10-04로 틀렸다. 1101/10-04다.

고른 방법(리뷰 문서 ⓐ):
- capabilities 검사 8개를 `playwright-capabilities-run-isolation.test.ts`로
  옮기고 설정을 이름으로 import한다. browser-file-storage 드릴이 설정과
  이 파일을 이름으로 함께 지운다. 같은 드릴이 `ci-workflow-generation`
  테스트를 지우는 방식이다. `force` 없이 지워, 이름이 바뀐 파일은 드릴이
  그 자리에서 멈춘다.
- 두 파일이 같은 검사를 쓰도록 불러오기·포트·결과 폴더 검사를
  `tests/helpers/playwright-run-isolation.ts`로 뺐다. 단언은 그대로다.
- `vite-build-inputs`는 빌드 테스트를 늘 읽는다. 측정 스크립트는 그
  파일을 가진 제거 가능 기능(`removable-template-features.ts`)이 설치돼
  있을 때(feature-module.ts가 있을 때, verify:documentation과 같은 규칙)
  읽는다. 그 소유 기능이 없으면 실패한다. 기능 ID를 테스트에 쓰지 않는
  것은 샘플 드릴의 residue 검사가 `src`·`tests`의 샘플 이름을 잡기 때문이다.
- 틀린 ID 주석은 옮긴 검사와 함께 없어지고, 새 파일 머리말에 1101/10-04로
  적었다.
버린 대안: 드릴이 표시를 넘기고 테스트가 읽는 방식(ⓑ). 드릴과 테스트
사이 계약이 늘고, capability를 지우는 제품이 테스트를 고쳐야 한다. 주석
ID만 고치기(ⓒ)는 공백이 남는다.

위험·한계:
- 테스트 수는 템플릿 33개(25 + 8)로 같다. browser-file-storage 사본에서는
  25개가 돌고 8개는 파일째 지워진다(드릴 코드에 적힘).
- 측정 스크립트의 조건은 여전히 파일 존재(소유 기능의 feature-module.ts)다.
  대상이 지울 수 있다고 등록된 소유자로 바뀌었다.
- 이 노트북에서는 실행하지 못했다.

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/playwright-run-isolation.test.ts tests/unit/playwright-capabilities-run-isolation.test.ts tests/unit/vite-build-inputs.test.ts
이름 바꾸기 변이 둘(capabilities 설정, product-feature-selection-build
테스트), check:types, lint, ci:gate FE-GATE-020

Refs: 1106/10-01
2026-11-06 05:27:21 +09:00

93 lines
3.7 KiB
TypeScript

import { readFileSync } from "node:fs";
import { afterEach, describe, expect, it } from "vitest";
import {
configRuns,
describeResultFolders,
describeServerPorts,
itExitsWhenItsPortIsTaken,
itKeepsTheViteCacheInTheRun,
releaseRuns,
webServer,
} from "../helpers/playwright-run-isolation.ts";
/**
* 1105/12-04. Every Playwright config wrote its results, report and JUnit
* file, and the e2e and visual builds wrote `dist`, at fixed paths. A second
* run in one checkout deleted the first one's results (Playwright empties
* `outputDir` at start) and emptied the `dist` its preview was serving. Under
* TEST_RUN_ID each run gets its own paths; without it the paths stay where
* FE-GATE-008 and the CI upload read them.
*
* The servers listened on fixed ports (e2e 4173, visual and capabilities both
* 4174, storybook 6006, dev 5173), so the second run failed with "is already
* used", and the dev config reused whatever answered on 5173. Each now picks
* a free port, which the runner's environment hands to the workers.
*
* Each load evaluates the config again with the environment of one process.
*
* 1106/10-01. The capabilities config is checked in
* tests/unit/playwright-capabilities-run-isolation.test.ts: it goes with the
* browser file/storage runtime, and test:browser-file-storage-removal deletes
* the config and that file by name. This file has the four configs every
* project has.
*/
const runs = configRuns({
e2e: () => import("../../playwright.config.ts"),
visual: () => import("../../playwright.visual.config.ts"),
storybook: () => import("../../playwright.storybook.config.ts"),
dev: () => import("../../playwright.dev.config.ts"),
});
afterEach(releaseRuns);
describeResultFolders(runs, [
["e2e", "e2e"],
["visual", "visual"],
["storybook", "storybook"],
]);
describe("the build a run serves", () => {
it.each(["e2e", "visual"] as const)(
"is the checkout's dist without a run ID, and the run's own with one (%s)",
async (name) => {
const checkout = webServer(await runs.load(name));
expect(checkout.env?.["RUN_OUTPUT_ROOT"]).toBe(".");
expect(checkout.command).toMatch(/ --outDir dist(?: |$)/u);
const run = webServer(await runs.load(name, { TEST_RUN_ID: "a" }));
// The build writes under RUN_OUTPUT_ROOT and the preview serves it.
expect(run.env?.["RUN_OUTPUT_ROOT"]).toBe(".tmp/runs/a");
expect(run.command).toMatch(/^corepack pnpm build && corepack pnpm preview /u);
expect(run.command).toMatch(/ --outDir \.tmp\/runs\/a\/dist(?: |$)/u);
},
);
itKeepsTheViteCacheInTheRun(runs, ["dev"]);
it("builds the workshop into the run's folder the way build:storybook does", async () => {
const checkout = webServer(await runs.load("storybook")).command;
expect(checkout).toMatch(
/^corepack pnpm build:storybook && node scripts\/serve-static\.ts artifacts\/storybook\/static /u,
);
const run = webServer(await runs.load("storybook", { TEST_RUN_ID: "a" })).command;
const script = (
JSON.parse(readFileSync("package.json", "utf8")) as { scripts: Record<string, string> }
).scripts["build:storybook"]!;
const sameStepsOtherFolder = script
.replace("&& storybook build", "&& corepack pnpm exec storybook build")
.replace("-o artifacts/storybook/static", "-o .tmp/runs/a/artifacts/storybook/static");
expect(sameStepsOtherFolder).not.toBe(script);
expect(run.startsWith(`${sameStepsOtherFolder} && `)).toBe(true);
expect(run).toMatch(/ node scripts\/serve-static\.ts \.tmp\/runs\/a\/artifacts\/storybook\/static /u);
});
});
describeServerPorts(runs, ["e2e", "visual", "storybook", "dev"]);
describe("vite servers", () => {
itExitsWhenItsPortIsTaken(runs, ["e2e", "visual", "dev"]);
});