fix(bundle): 예산을 넘으면 넘은 한도와 초과량을 출력하고 초기 파일 수를 막는다
문제: 초기 JS가 예산을 넘으면 check:bundle은 "Bundle budget or manifest integrity failed: " 한 줄만 쓰고 콜론 뒤가 비어 있었다. 측정값과 한도는 artifacts/performance/bundle.json에만 있어 예산 실패인지 manifest 무결성 실패인지, 몇 바이트 넘었는지 알 수 없었다. 또 초기 JS 파일 수에는 상한이 없어 08-08처럼 파일을 16개에서 25개로 늘리는 변경도 모든 게이트를 통과했다. 템플릿은 HTTP/2를 전제로 초기 청크를 나눠 두었는데, 파일 수를 늘리는 결정이 어디에도 드러나지 않았다. 고른 방법: 예산 실패와 무결성 실패를 다른 문장으로 쓴다. 예산 실패는 넘은 한도마다 측정값·한도·초과량을 한 줄로 쓴다 (describeBundleBudgetFailures). config/performance/budgets.json에 initialJsFiles(지금 25)를 두고 check:bundle이 entry를 포함한 초기 파일 수를 센다. bundle.json 스키마는 측정값·한도·결과와 자가 검사 fixture를 하나씩 더 가진다. 두 변경은 같은 함수와 스키마를 고치므로 한 커밋에 넣었다. 버린 대안: 파일 수를 문서에만 적기. 08-08이 그 상태에서 파일을 늘렸다. 위험·한계: 초기 파일을 하나라도 늘리는 변경은 이제 budgets.json을 같이 고쳐야 통과한다. 그것이 목적이다. HTTP/2 확인 자체는 이 커밋에 없다 (13-02에서 probe에 넣는다). 검증: tests/unit/check-bundle-output.test.ts가 손으로 만든 빌드 출력에 check-bundle.ts를 돌려 통과·초기 바이트 초과·lazy 초과·파일 수 초과· 무결성 실패의 출력을 본다(고치기 전 4건 실패). bundle-artifact-contract, performance-budgets 통과. 실제 빌드에서 check:bundle PASS(25 / 25 files). Refs: docs/reviews/2026-11-03-maturity-review/15-performance.md 15-03, 15-05
This commit is contained in:
@@ -28,6 +28,7 @@ const completed = {
|
||||
...inventory,
|
||||
measurements: {
|
||||
initialJsGzipBytes: 50,
|
||||
initialJsFiles: 1,
|
||||
lazyChunks: [{ path: "assets/lazy.js", gzipBytes: 40 }],
|
||||
},
|
||||
classification: {
|
||||
@@ -36,9 +37,10 @@ const completed = {
|
||||
missingImports: [],
|
||||
},
|
||||
missingOutputs: [],
|
||||
thresholds: { initialJsGzipBytes: 60, lazyChunkGzipBytes: 45 },
|
||||
thresholds: { initialJsGzipBytes: 60, initialJsFiles: 1, lazyChunkGzipBytes: 45 },
|
||||
results: {
|
||||
initialPassed: true,
|
||||
initialFilesPassed: true,
|
||||
lazyResults: [
|
||||
{ path: "assets/lazy.js", gzipBytes: 40, threshold: 45, passed: true },
|
||||
],
|
||||
@@ -47,6 +49,7 @@ const completed = {
|
||||
fixtures: [
|
||||
{ name: "initial-js-over-budget", passed: true },
|
||||
{ name: "lazy-chunk-over-budget", passed: true },
|
||||
{ name: "initial-files-over-budget", passed: true },
|
||||
],
|
||||
passed: true,
|
||||
} as const;
|
||||
@@ -64,8 +67,10 @@ describe("bundle artifact contracts", () => {
|
||||
["lazy classification", { classification: { ...completed.classification, lazyFiles: [] } }],
|
||||
["missing output", { missingOutputs: ["assets/missing.js"], passed: true }],
|
||||
["threshold result", { results: { ...completed.results, initialPassed: false } }],
|
||||
["initial file count", { measurements: { ...completed.measurements, initialJsFiles: 2 } }],
|
||||
["initial file result", { results: { ...completed.results, initialFilesPassed: false } }],
|
||||
["lazy result", { results: { ...completed.results, lazyResults: [] } }],
|
||||
["fixture identity", { fixtures: [{ name: "other", passed: true }, completed.fixtures[1]] }],
|
||||
["fixture identity", { fixtures: [{ name: "other", passed: true }, completed.fixtures[1], completed.fixtures[2]] }],
|
||||
["overall result", { passed: false }],
|
||||
] as const)("rejects inconsistent %s evidence", (_name, mutation) => {
|
||||
expect(() =>
|
||||
|
||||
@@ -0,0 +1,128 @@
|
||||
import { spawnSync } from "node:child_process";
|
||||
import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
|
||||
import { tmpdir } from "node:os";
|
||||
import path from "node:path";
|
||||
|
||||
import { afterEach, describe, expect, it } from "vitest";
|
||||
|
||||
/**
|
||||
* 1103/15-03. An over-budget build printed only
|
||||
* "Bundle budget or manifest integrity failed: " with nothing after the
|
||||
* colon, so the first budget failure a project meets named neither the limit
|
||||
* nor the excess. check-bundle runs here on a hand-made build output.
|
||||
*/
|
||||
const roots: string[] = [];
|
||||
|
||||
afterEach(async () => {
|
||||
await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
|
||||
});
|
||||
|
||||
type Output = Readonly<{ path: string; gzipBytes: number }>;
|
||||
|
||||
async function checkBundle(
|
||||
options: Readonly<{
|
||||
outputs: readonly Output[];
|
||||
manifest: Record<string, unknown>;
|
||||
budgets: Record<string, number>;
|
||||
}>,
|
||||
) {
|
||||
const root = await mkdtemp(path.join(tmpdir(), "check-bundle-output-"));
|
||||
roots.push(root);
|
||||
const write = async (file: string, value: unknown) => {
|
||||
await mkdir(path.dirname(path.join(root, file)), { recursive: true });
|
||||
await writeFile(path.join(root, file), `${JSON.stringify(value, null, 2)}\n`);
|
||||
};
|
||||
await write("config/performance/budgets.json", { schemaVersion: 1, bundle: options.budgets });
|
||||
await write("dist/.vite/manifest.json", options.manifest);
|
||||
await write("artifacts/performance/bundle.json", {
|
||||
schemaVersion: 1,
|
||||
generatedAt: "2026-11-04T00:00:00.000Z",
|
||||
context: { nodeVersion: "v24.14.0", packageManager: "pnpm@11.17.0", runnerImage: "fixture" },
|
||||
outputs: options.outputs.map((output) => ({
|
||||
path: `dist/${output.path}`,
|
||||
bytes: output.gzipBytes * 3,
|
||||
gzipBytes: output.gzipBytes,
|
||||
sha256: "a".repeat(64),
|
||||
})),
|
||||
});
|
||||
const result = spawnSync(process.execPath, [path.resolve("scripts/check-bundle.ts")], {
|
||||
cwd: root,
|
||||
encoding: "utf8",
|
||||
});
|
||||
return { status: result.status, stdout: result.stdout, stderr: result.stderr };
|
||||
}
|
||||
|
||||
const MANIFEST = {
|
||||
"index.html": {
|
||||
file: "assets/index-A.js",
|
||||
isEntry: true,
|
||||
imports: ["_boot"],
|
||||
},
|
||||
// The entry's own dynamic imports are initial (09-03); a route's are lazy.
|
||||
_boot: { file: "assets/boot-B.js", dynamicImports: ["src/lazy.tsx"] },
|
||||
"src/lazy.tsx": { file: "assets/lazy-C.js" },
|
||||
};
|
||||
const OUTPUTS = [
|
||||
{ path: "assets/index-A.js", gzipBytes: 400 },
|
||||
{ path: "assets/boot-B.js", gzipBytes: 500 },
|
||||
{ path: "assets/lazy-C.js", gzipBytes: 300 },
|
||||
];
|
||||
const BUDGETS = { initialJsGzipBytes: 1_000, initialJsFiles: 2, lazyChunkGzipBytes: 400 };
|
||||
|
||||
describe("check:bundle failure output (1103/15-03)", () => {
|
||||
it("passes and prints the total within budget", async () => {
|
||||
const result = await checkBundle({ outputs: OUTPUTS, manifest: MANIFEST, budgets: BUDGETS });
|
||||
expect(result.stderr).toBe("");
|
||||
expect(result.status).toBe(0);
|
||||
expect(result.stdout).toContain("initial JS 900 / 1000 gzip bytes");
|
||||
});
|
||||
|
||||
it("names the measured initial total, the budget and the excess", async () => {
|
||||
const result = await checkBundle({
|
||||
outputs: OUTPUTS,
|
||||
manifest: MANIFEST,
|
||||
budgets: { ...BUDGETS, initialJsGzipBytes: 899 },
|
||||
});
|
||||
expect(result.status).toBe(1);
|
||||
expect(result.stderr).toContain("Bundle budget failed (config/performance/budgets.json):");
|
||||
expect(result.stderr).toContain("initial JavaScript 900 gzip bytes > budget 899 (over by 1)");
|
||||
expect(result.stderr).not.toContain("manifest integrity");
|
||||
});
|
||||
|
||||
it("names each lazy chunk over its budget", async () => {
|
||||
const result = await checkBundle({
|
||||
outputs: OUTPUTS,
|
||||
manifest: MANIFEST,
|
||||
budgets: { ...BUDGETS, lazyChunkGzipBytes: 250 },
|
||||
});
|
||||
expect(result.status).toBe(1);
|
||||
expect(result.stderr).toContain(
|
||||
"lazy chunk assets/lazy-C.js 300 gzip bytes > budget 250 (over by 50)",
|
||||
);
|
||||
});
|
||||
|
||||
// 1103/15-05. The entry preloads every initial file at once; over HTTP/1.1
|
||||
// they queue for six connections. A change that adds an initial file is a
|
||||
// decision recorded in the budget, not a side effect.
|
||||
it("fails when the initial JavaScript has more files than the budget", async () => {
|
||||
const result = await checkBundle({
|
||||
outputs: OUTPUTS,
|
||||
manifest: MANIFEST,
|
||||
budgets: { ...BUDGETS, initialJsFiles: 1 },
|
||||
});
|
||||
expect(result.status).toBe(1);
|
||||
expect(result.stderr).toContain("initial JavaScript files 2 > budget 1 (over by 1)");
|
||||
});
|
||||
|
||||
it("reports a manifest integrity failure apart from the budget", async () => {
|
||||
const result = await checkBundle({
|
||||
outputs: OUTPUTS.filter(({ path: file }) => file !== "assets/boot-B.js"),
|
||||
manifest: MANIFEST,
|
||||
budgets: BUDGETS,
|
||||
});
|
||||
expect(result.status).toBe(1);
|
||||
expect(result.stderr).toContain("Bundle manifest integrity failed:");
|
||||
expect(result.stderr).toContain("output missing from the inventory: assets/boot-B.js");
|
||||
expect(result.stderr).not.toContain("Bundle budget failed");
|
||||
});
|
||||
});
|
||||
@@ -11,11 +11,12 @@ describe("performance budgets", () => {
|
||||
it("rejects initial and lazy JavaScript above their named limits", () => {
|
||||
const thresholds = {
|
||||
initialJsGzipBytes: 200,
|
||||
initialJsFiles: 2,
|
||||
lazyChunkGzipBytes: 120,
|
||||
};
|
||||
expect(
|
||||
evaluateBundleBudget(
|
||||
{ initialJsGzipBytes: 201, lazyChunks: [] },
|
||||
{ initialJsGzipBytes: 201, initialJsFiles: 1, lazyChunks: [] },
|
||||
thresholds,
|
||||
).passed,
|
||||
).toBe(false);
|
||||
@@ -23,11 +24,18 @@ describe("performance budgets", () => {
|
||||
evaluateBundleBudget(
|
||||
{
|
||||
initialJsGzipBytes: 100,
|
||||
initialJsFiles: 1,
|
||||
lazyChunks: [{ path: "lazy.js", gzipBytes: 121 }],
|
||||
},
|
||||
thresholds,
|
||||
).passed,
|
||||
).toBe(false);
|
||||
expect(
|
||||
evaluateBundleBudget(
|
||||
{ initialJsGzipBytes: 100, initialJsFiles: 3, lazyChunks: [] },
|
||||
thresholds,
|
||||
),
|
||||
).toMatchObject({ initialPassed: true, initialFilesPassed: false, passed: false });
|
||||
});
|
||||
|
||||
it("fails lab evidence when context is absent or a metric is over budget", () => {
|
||||
|
||||
Reference in New Issue
Block a user