문제: context gateway의 `ContextErrorBoundary`·`FeatureErrorBoundary`는
`onError`를 받지 않아 잡은 실패를 진단에 남기지 않고, 화면 지원 참조는
buildId뿐이다. 라우트 모듈이 청크 누락이 아닌 이유로 실패할 때(평가 중
throw, 15-01 뒤로는 기능 실행부 적재 실패)도 같은 화면만 그리고 기록이
없다. 안쪽 경계(`RenderErrorBoundary`) 밖에서 난 실패, 예를 들어 핸들의
route id가 레지스트리에 없거나 핸들에 라우트 codec이 없을 때는 사용자
신고로도 사건을 찾을 수 없다. 0929/08-05와 같은 결함이다.
고른 방법:
- `ScopedErrorBoundary`가 잡을 때 incident id를 만들어 `onError` 보고에
넣고, 함수형 fallback에 같은 id를 넘긴다. 둘 다 추가 변경이다(기존
ReactNode fallback과 `{scope, ownerId}`를 읽는 쪽은 그대로 동작).
- incident id 생성기를 `src/platform/errors/incident-id.ts`로 옮겨 두
경계 계열이 같은 함수를 쓴다(platform은 presentation을 import할 수 없다).
- gateway가 두 경계에 `reportRenderFailure` 호출과
`<buildId>:<incidentId>` 지원 참조를 넘긴다. context 경계는
`component_boundary`를 "route"로 보고한다. 진단·텔레메트리 계약에
context 값이 없고, 같은 gateway의 청크 복구 보고도 "route"를 쓴다.
- 비청크 적재 실패는 context 경계 안에서 다시 throw해 같은 보고 경로를
탄다. route id는 URL의 등록 라우트, 없으면 context id다.
버린 대안:
- 세 곳을 presentation `RouteBoundary`로 바꾸기(0929/08-05 제안): 경계
두 계열 통합(리팩토링 R4) 성격이고 context/feature 소유 범위 표시
(`data-boundary`, testid)가 바뀐다.
- gateway가 URL마다 incident id를 하나 만들어 두 경계에 나눠 주기:
두 경계가 같은 id를 공유해 사건 구분이 흐려진다.
- `component_boundary`에 "context" 추가: 진단·텔레메트리 계약과
레지스트리 기준선을 바꾸는 일이라 이번 범위 밖이다.
위험·한계:
- `APP_SHELL`의 `errorElement`(0929/08-05가 함께 적은 곳)는 그대로
buildId만 보이고 보고하지 않는다. React Router 오류 요소라 다른 방식
(useRouteError + 마운트 시 보고)이 필요해 남겼다.
- 실패한 context 안에서 URL을 바꾸면 경계가 리셋되고 다시 throw해 방문마다
한 번 보고한다.
- 화면 변화: context·feature 경계 실패 화면과 비청크 적재 실패 화면의
지원 참조가 `build:incident` 형식이 된다. 시각 골든에는 없는 화면이다.
- 초기 JS +58 B gzip(202,748 → 202,806 B, 여유 1,994 B).
검증:
- RED: tests/component/context-boundary-diagnostics.test.tsx 3건(context
경계: 미등록 핸들 id, feature 경계: codec 없는 핸들, 비청크 적재 실패)이
모두 `Unable to find an element with the text: /^지원 참조:
build-a:[0-9a-f]{8}$/`로 실패. 화면은 "지원 참조: build-a"였다.
- GREEN: 3건 통과. failure-boundary.test.tsx에 함수형 fallback이 보고한
incident id를 받는지 1건 추가, `onError` 보고 기대값에 incidentId 추가.
- 회귀: tests/{architecture,platform,component,features,scripts,contract}
95 files / 592 tests, tests/unit(pnpm을 띄우는 5개 제외) 164 files /
1,929 tests 통과. tsc app·test 통과. 바꾼 파일 eslint 통과.
check-architecture(shim), check-adapter-inventory, check-diagnostics,
check-registries 통과.
106 lines
3.6 KiB
TypeScript
106 lines
3.6 KiB
TypeScript
// @vitest-environment jsdom
|
|
|
|
import { render, screen } from "@testing-library/react";
|
|
import { describe, expect, it, vi } from "vitest";
|
|
|
|
import { ContextErrorBoundary } from "../../../src/platform/errors/context-error-boundary.tsx";
|
|
import { FeatureErrorBoundary } from "../../../src/platform/errors/feature-error-boundary.tsx";
|
|
|
|
function ThrowsOnRender(): never {
|
|
throw new Error("feature render failed");
|
|
}
|
|
|
|
describe("ownership-aligned failure boundaries", () => {
|
|
it("keeps sibling feature UI mounted when one feature throws during render", () => {
|
|
vi.spyOn(console, "error").mockImplementation(() => {});
|
|
render(
|
|
<ContextErrorBoundary>
|
|
<FeatureErrorBoundary featureId="broken">
|
|
<ThrowsOnRender />
|
|
</FeatureErrorBoundary>
|
|
<div>healthy-feature</div>
|
|
</ContextErrorBoundary>,
|
|
);
|
|
|
|
expect(screen.getByText("healthy-feature")).toBeInTheDocument();
|
|
expect(screen.getByTestId("feature-fallback-broken")).toBeInTheDocument();
|
|
});
|
|
|
|
it("keeps sibling contexts mounted when one context fails outside any feature boundary", () => {
|
|
vi.spyOn(console, "error").mockImplementation(() => {});
|
|
render(
|
|
<main>
|
|
<ContextErrorBoundary contextId="commerce">
|
|
<ThrowsOnRender />
|
|
</ContextErrorBoundary>
|
|
<ContextErrorBoundary contextId="account">
|
|
<p>account-context</p>
|
|
</ContextErrorBoundary>
|
|
<nav>app-shell</nav>
|
|
</main>,
|
|
);
|
|
|
|
expect(screen.getByTestId("context-fallback-commerce")).toBeInTheDocument();
|
|
expect(screen.getByText("account-context")).toBeInTheDocument();
|
|
expect(screen.getByText("app-shell")).toBeInTheDocument();
|
|
});
|
|
|
|
it("reports once per contained failure and survives a throwing reporter", () => {
|
|
vi.spyOn(console, "error").mockImplementation(() => {});
|
|
const onError = vi.fn(() => {
|
|
throw new Error("diagnostics down");
|
|
});
|
|
render(
|
|
<FeatureErrorBoundary featureId="broken" onError={onError} fallback={<p>fallback</p>}>
|
|
<ThrowsOnRender />
|
|
</FeatureErrorBoundary>,
|
|
);
|
|
expect(onError).toHaveBeenCalledWith({
|
|
scope: "feature",
|
|
ownerId: "broken",
|
|
incidentId: expect.stringMatching(/^[0-9a-f]{8}$/),
|
|
});
|
|
expect(screen.getByText("fallback")).toBeInTheDocument();
|
|
});
|
|
|
|
// 09-09. The support reference on screen has to find the reported event.
|
|
it("gives a function fallback the incident id it reported", () => {
|
|
vi.spyOn(console, "error").mockImplementation(() => {});
|
|
const onError = vi.fn();
|
|
render(
|
|
<ContextErrorBoundary
|
|
contextId="commerce"
|
|
onError={onError}
|
|
fallback={(incidentId) => <p>incident {incidentId}</p>}
|
|
>
|
|
<ThrowsOnRender />
|
|
</ContextErrorBoundary>,
|
|
);
|
|
const [[report]] = onError.mock.calls as [[{ incidentId: string }]];
|
|
expect(screen.getByText(`incident ${report.incidentId}`)).toBeInTheDocument();
|
|
});
|
|
|
|
it("clears a contained failure when its reset key changes", () => {
|
|
vi.spyOn(console, "error").mockImplementation(() => {});
|
|
let shouldThrow = true;
|
|
function Flaky() {
|
|
if (shouldThrow) throw new Error("flaky");
|
|
return <p>recovered</p>;
|
|
}
|
|
const view = render(
|
|
<FeatureErrorBoundary featureId="flaky" resetKey="/a">
|
|
<Flaky />
|
|
</FeatureErrorBoundary>,
|
|
);
|
|
expect(screen.getByTestId("feature-fallback-flaky")).toBeInTheDocument();
|
|
|
|
shouldThrow = false;
|
|
view.rerender(
|
|
<FeatureErrorBoundary featureId="flaky" resetKey="/b">
|
|
<Flaky />
|
|
</FeatureErrorBoundary>,
|
|
);
|
|
expect(screen.getByText("recovered")).toBeInTheDocument();
|
|
});
|
|
});
|