/** * @file RouteErrorBoundary.test.tsx * @description The route error boundary: a failed lazy chunk (stale assets after * a self-update) reloads the page once; any other error — or a second chunk * failure — shows the themed Reload fallback instead of a blank app. * @author Nguyễn Ngọc Trí Vĩ */ import { describe, it, expect, vi, beforeEach, afterEach } from "vitest"; import { render, screen } from "@testing-library/react"; import { RouteErrorBoundary, isChunkLoadError, reloadOnce } from "../RouteErrorBoundary"; function Boom({ error }: { error: Error }): never { throw error; } let reload: ReturnType; beforeEach(() => { sessionStorage.clear(); reload = vi.fn(); vi.spyOn(console, "error").mockImplementation(() => {}); }); afterEach(() => vi.restoreAllMocks()); describe("RouteErrorBoundary", () => { it("recognises dynamic-import failures", () => { expect( isChunkLoadError(new TypeError("Failed to fetch dynamically imported module: /a.js")) ).toBe(true); expect(isChunkLoadError(Object.assign(new Error("x"), { name: "ChunkLoadError" }))).toBe(true); expect(isChunkLoadError(new Error("Importing a module script failed."))).toBe(true); expect(isChunkLoadError(new Error("boom"))).toBe(false); }); it("reloads once on a chunk error, never twice in a row", () => { expect(reloadOnce(reload)).toBe(true); expect(reloadOnce(reload)).toBe(false); expect(reload).toHaveBeenCalledTimes(1); }); it("shows a Reload fallback for an ordinary render error", () => { render( ); expect(screen.getByRole("alert")).toHaveTextContent(/something went wrong/i); expect(screen.getByRole("button", { name: /reload/i })).toBeInTheDocument(); expect(reload).not.toHaveBeenCalled(); }); it("clears the error when the route changes, so the next page renders", () => { const { rerender } = render( ); expect(screen.getByRole("alert")).toBeInTheDocument(); rerender(

settings page

); expect(screen.getByRole("alert")).toBeInTheDocument(); rerender(

settings page

); expect(screen.queryByRole("alert")).not.toBeInTheDocument(); expect(screen.getByText("settings page")).toBeInTheDocument(); }); it("reloads on a chunk error the first time", () => { render( ); expect(reload).toHaveBeenCalledTimes(1); }); });