Files
tech-log-frontend/tests/unit/build-environment-bundle.test.ts
T
DongHyeonka ed47b562bc perf(build): react-dom을 자기 청크로 빼 빌드 id만 바뀐 배포의 캐시 손실을 줄인다
빌드 id는 부트 실패 화면이 보여 주므로 render-boot-failure 청크에
들어간다(getBuildConfig). react-dom과 scheduler가 같은 청크에 있어서
빌드 id만 다른 두 빌드에서 그 190,478 B 청크의 이름이 바뀌었다. 해시
자산은 오래 캐시되는데, 재방문 사용자는 코드가 같아도 배포마다 이만큼
다시 받았다. 단위 시험 build-environment-bundle이 이 청크가 바뀐다고
실패했다.

템플릿 af6d0a9f(1103/15-06)와 같은 방식이다. manualChunks에서 react-dom·
scheduler를 react-dom 청크로 뺀다. 시험은 템플릿 새 판처럼 디자인 시스템
청크를 이름 대신 내용(ui-button--pending)으로 찾아 고정됐는지 보고,
react-dom 청크가 고정이며 render-boot-failure가 아닌지 본다. 이전 시험은
빌드 id를 일부러 담는 render-boot-failure를 공용 청크로 잘못 골랐다.

위험·한계: 정규식은 pnpm의 node_modules 배치를 가정한다. 배치가 바뀌어
그룹이 비면 시험이 실패한다. boot(약 320 KB)는 빌드 id로 설정을 대조하므로
계속 이름이 바뀐다(템플릿과 같음).

검증: 빌드 id만 다른 두 빌드에서 이름이 바뀐 청크는 boot·index·
render-boot-failure 셋이고, render-boot-failure는 12,138 B로 줄었다.
react-dom 청크와 디자인 시스템 청크는 두 빌드에서 이름이 같다.
2026-11-12 12:50:28 +09:00

105 lines
4.4 KiB
TypeScript

import { spawnSync } from "node:child_process";
import { mkdtemp, readFile, rm } from "node:fs/promises";
import { tmpdir } from "node:os";
import path from "node:path";
import { afterAll, describe, expect, it } from "vitest";
import { filesBelow } from "../../scripts/lib/removal-fixture.ts";
/**
* 13-06. Which VITE_* values reach the bundle. The declared values the app
* reads must still be there (build id, commit, runtime config URL, base path);
* a declared value nothing reads and an undeclared one must not be, and the
* design-system chunk must not change with the build id.
*/
const roots: string[] = [];
afterAll(async () => {
await Promise.all(roots.map((root) => rm(root, { recursive: true, force: true })));
});
function inheritedEnvironment(): NodeJS.ProcessEnv {
return Object.fromEntries(
Object.entries(process.env).filter(([name]) => !name.startsWith("VITE_")),
);
}
async function build(variables: Readonly<Record<string, string>>) {
const outDir = await mkdtemp(path.join(tmpdir(), "build-environment-"));
roots.push(outDir);
const run = spawnSync(
path.resolve("node_modules/.bin/vite"),
["build", "--outDir", outDir, "--emptyOutDir", "--logLevel", "error"],
{ encoding: "utf8", env: { ...inheritedEnvironment(), ...variables } },
);
const contents = run.status === 0
? await Promise.all(
(await filesBelow(outDir))
.filter((file) => /\.(?:js|html)$/u.test(file))
.map(async (file) => ({ file, text: await readFile(file, "utf8") })),
)
: [];
return { run, outDir, contents };
}
const DECLARED = Object.freeze({
VITE_COMMIT_SHA: "commit-probe-13",
VITE_ROUTER_BASE_PATH: "/base-probe/",
VITE_RUNTIME_CONFIG_URL: "/base-probe/runtime-probe.json",
// Declared, but applied by the index generator; the bundle never reads it.
VITE_PRODUCT_FEATURES: "unreferenced-probe-13",
});
describe("build variables in the bundle (13-06)", () => {
it("keeps the values the app reads and nothing else", async () => {
const first = await build({ ...DECLARED, VITE_BUILD_ID: "build-probe-1" });
expect(first.run.stderr).toBe("");
expect(first.run.status).toBe(0);
const bundled = (value: string) =>
first.contents.some(({ text }) => text.includes(value));
expect(bundled("build-probe-1")).toBe(true);
expect(bundled("commit-probe-13")).toBe(true);
expect(bundled("/base-probe/runtime-probe.json")).toBe(true);
const html = first.contents.find(({ file }) => file.endsWith("index.html"));
expect(html?.text).toContain('src="/base-probe/assets/');
expect(bundled("unreferenced-probe-13")).toBe(false);
const second = await build({ ...DECLARED, VITE_BUILD_ID: "build-probe-2" });
expect(second.run.status).toBe(0);
// The design system, found by what it holds rather than by name: this
// product's route chunk split (vite.config.ts) names chunks after route
// modules, and upstream's `design-system-*` does not exist here.
// (The previous check looked at `render-boot-failure-*`, which holds the
// build id on purpose and can never keep its name.)
const designSystem = ({ contents }: Awaited<ReturnType<typeof build>>) =>
contents
.filter(({ file, text }) =>
file.endsWith(".js") && text.includes("ui-button--pending"),
)
.map(({ file }) => path.basename(file));
const firstChunks = designSystem(first);
expect(firstChunks).toHaveLength(1);
expect(designSystem(second)).toEqual(firstChunks);
// Template 1103/15-06. react-dom sat in the boot-failure chunk with the
// build id, so every release renamed it and returning visitors downloaded
// it again. Its own chunk keeps the name while only the build id changes.
const reactDom = ({ contents }: Awaited<ReturnType<typeof build>>) =>
contents
.filter(({ file, text }) => file.endsWith(".js") && text.includes("__reactContainer$"))
.map(({ file }) => path.basename(file));
expect(reactDom(first)).toHaveLength(1);
expect(reactDom(first)[0]).not.toMatch(/render-boot-failure/u);
expect(reactDom(second)).toEqual(reactDom(first));
}, 120_000);
it("refuses a VITE_* variable the build does not declare", async () => {
const refused = await build({ VITE_PAYMENT_KEY: "sk_live_probe" });
expect(refused.run.status).not.toBe(0);
expect(refused.run.stderr + refused.run.stdout).toMatch(
/Undeclared VITE_\* build variables: VITE_PAYMENT_KEY/u,
);
}, 120_000);
});