문제: 플랫폼 구성 화면(lab 대상)은 getReleaseSummary()가 끝날 때까지 릴리스 신원 칸을 "상태" 한 칸으로 그리고, 끝나면 hint 줄이 있는 네 칸으로 바꾼다. 제목이 보인 뒤 약 30~100 ms에 grid가 hint 한 줄만큼 커져 아래 section이 21 px 내려간다(layout shift 0.00461, 리뷰 15-platform-shift 16회). lab은 `/`에서 클릭으로만 들어가고, 클릭 뒤 500 ms 안의 shift는 hadRecentInput이라 CLS에서 빠지므로 0을 낸다. `/` 밖의 라우트 CLS는 어느 게이트도 보지 않는다. 고른 방법: - 화면: 요약 전·실패 때도 같은 네 칸(빌드·릴리스·설정 스키마·계약 집합 다이제스트)을 같은 hint 줄 구성으로 그린다. 값만 "확인하고 있습니다." / "확인하지 못했습니다." / "—"다. 상태 문장은 가장 좁은 칸(13rem)에서도 한 줄이 되게 짧게 했다. dl에 aria-busy를 둔다. 시각 테스트는 이미 `main [aria-busy='true']`가 0개가 될 때까지 기다리므로, dt만 보고 찍던 대기가 값이 채워진 뒤로 유지된다. - lab: run마다 대상 라우트를 새 context에서 직접 열고 heading 뒤 network idle까지의 CLS를 잰다(metrics.targetDeepLinkCls, 중앙값, context.sampling.targetDeepLink에 표본). evaluateLabBudget가 lab.cls 임계값으로 판정한다. 클릭 시계(상호작용 중앙값)와 대상 라우트는 그대로다. - 컴포넌트 테스트: 요약 전과 후의 칸 이름·hint 유무가 같다. 실패 테스트는 빌드 칸의 값으로 본다. 단위 테스트: 직접 진입 CLS가 임계값을 넘으면 lab 판정이 실패한다. 버린 대안: 릴리스 요약을 동기로 읽기 — getReleaseSummary()가 비동기 포트 계약이라 포트를 바꿔야 한다. 클릭 run에서 hadRecentInput을 무시 — CLS 정의와 달라져 field 값과 비교할 수 없다. 위험·한계: lab 시간이 run마다 cold navigation 하나(lab 조건 약 2~3초) 늘어 5회면 +10~15초다. 직접 진입 CLS 예산은 0.1이라 0.0046 같은 작은 shift는 실패시키지 않고 lab.json에 값으로만 남는다. layout shift 0건은 lab 값(0)과 15-platform-shift 방법으로 확인해야 한다. 상태 문구가 바뀌어 "런타임 정보를 확인하고 있습니다." 문장은 이 화면에서 사라졌다(홈 화면 문구는 그대로). lab.json 스키마 문서(config/schemas/lab-performance.schema.json)에 새 칸을 필수로 더했다. 검증: desktop batch에서 확인. node scripts/run-vitest.ts run tests/component/starter-platform-overview-page.test.tsx tests/unit/performance-budgets.test.ts corepack pnpm build && corepack pnpm test:performance -- --runs=5 (lab.json metrics.targetDeepLinkCls가 0인지) Refs: 1105/15-01
114 lines
3.3 KiB
TypeScript
114 lines
3.3 KiB
TypeScript
import { describe, expect, it } from "vitest";
|
|
|
|
import {
|
|
evaluateBundleBudget,
|
|
evaluateFieldBudget,
|
|
evaluateLabBudget,
|
|
percentile75,
|
|
} from "../../scripts/lib/performance-budgets.ts";
|
|
|
|
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, initialJsFiles: 1, lazyChunks: [] },
|
|
thresholds,
|
|
).passed,
|
|
).toBe(false);
|
|
expect(
|
|
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", () => {
|
|
const thresholds = { lcpMs: 2500, cls: 0.1, namedInteractionMs: 200 };
|
|
expect(
|
|
evaluateLabBudget(
|
|
{ metrics: { lcpMs: 1000, cls: 0, namedInteractionMs: 50, targetDeepLinkCls: 0 } },
|
|
thresholds,
|
|
),
|
|
).toMatchObject({ passed: false });
|
|
expect(
|
|
evaluateLabBudget(
|
|
{
|
|
context: {
|
|
runner: {},
|
|
browser: {},
|
|
viewport: {},
|
|
network: {},
|
|
cpu: {},
|
|
cache: {},
|
|
build: {},
|
|
},
|
|
metrics: { lcpMs: 2501, cls: 0, namedInteractionMs: 50, targetDeepLinkCls: 0 },
|
|
},
|
|
thresholds,
|
|
).passed,
|
|
).toBe(false);
|
|
});
|
|
|
|
/**
|
|
* 1105/15-01. The lab entered its target route only by a click, and a
|
|
* shift within 500 ms of a click is left out of CLS. The target screen
|
|
* pushed its content 21 px after its title and the lab reported 0. The
|
|
* direct visit's CLS is judged against the same threshold.
|
|
*/
|
|
it("fails lab evidence when a direct visit to the target route shifts over the CLS budget", () => {
|
|
const thresholds = { lcpMs: 2500, cls: 0.1, namedInteractionMs: 200 };
|
|
const context = {
|
|
runner: {},
|
|
browser: {},
|
|
viewport: {},
|
|
network: {},
|
|
cpu: {},
|
|
cache: {},
|
|
build: {},
|
|
};
|
|
const metrics = { lcpMs: 1000, cls: 0, namedInteractionMs: 50, targetDeepLinkCls: 0.0046 };
|
|
|
|
expect(evaluateLabBudget({ context, metrics }, thresholds).passed).toBe(true);
|
|
const shifted = evaluateLabBudget(
|
|
{ context, metrics: { ...metrics, targetDeepLinkCls: 0.11 } },
|
|
thresholds,
|
|
);
|
|
expect(shifted.passed).toBe(false);
|
|
expect(shifted.results).toMatchObject({ cls: true, targetDeepLinkCls: false });
|
|
});
|
|
|
|
it("uses the nearest-rank p75 and fails closed while sample minimum is deferred", () => {
|
|
expect(percentile75([4, 1, 3, 2])).toBe(3);
|
|
expect(
|
|
evaluateFieldBudget(
|
|
{
|
|
metrics: { p75LcpMs: 1000, p75Cls: 0.01, p75InpMs: 50 },
|
|
eligibleSamples: 100,
|
|
},
|
|
{
|
|
p75LcpMs: 2500,
|
|
p75Cls: 0.1,
|
|
p75InpMs: 200,
|
|
minimumEligibleSamples: null,
|
|
},
|
|
),
|
|
).toEqual({ status: "FAIL_UNVERIFIED", passed: false });
|
|
});
|
|
});
|