diff --git a/apps/taro/test/browser/admin-error-boundary.spec.ts b/apps/taro/test/browser/admin-error-boundary.spec.ts new file mode 100644 index 0000000..dcae219 --- /dev/null +++ b/apps/taro/test/browser/admin-error-boundary.spec.ts @@ -0,0 +1,130 @@ +import { test, expect, type Page, type Route } from "@playwright/test"; + +const adminOrigin = process.env.ADMIN_URL || "http://localhost:3005"; + +const pageErrors = new WeakMap(); + +test.beforeEach(({ page }) => { + const errors: string[] = []; + pageErrors.set(page, errors); + page.on("pageerror", (error) => errors.push(error.message)); +}); + +test.afterEach(({ page }) => { + expect(pageErrors.get(page) ?? []).toEqual([]); +}); + +interface MockOptions { + /** 品牌成员列表的异常返回,用于触发整页渲染错误 */ + memberships?: unknown; + /** 只在首次请求时返回的异常信任内容,重新加载后恢复 */ + trustContentOnce?: unknown; +} + +async function mockAdminApi(page: Page, options: MockOptions = {}) { + let servedTrustContent = false; + + await page.route("**/api/**", async (route: Route) => { + const request = route.request(); + const path = new URL(request.url()).pathname.replace(/^\/api/, ""); + const method = request.method(); + + if (path === "/admin/session/current") { + return route.fulfill({ + json: { + authenticated: true, + displayName: "品牌负责人", + role: "owner", + mustChangePassword: false, + platformTemplateRole: "none", + }, + }); + } + if (path === "/admin/config/brand") { + return route.fulfill({ + json: { + id: "brand-current", + name: "独立工坊", + slug: "atelier-studio", + tagline: "把耐心做进作品", + templateKey: "personal", + }, + }); + } + if (path === "/admin/brands" && method === "GET") { + return route.fulfill({ + json: options.memberships ?? [ + { + id: "membership-current", + role: "owner", + brand: { + id: "brand-current", + name: "独立工坊", + slug: "atelier-studio", + templateKey: "personal", + }, + }, + ], + }); + } + if (path === "/admin/config/trust-content" && method === "GET") { + if (!servedTrustContent && options.trustContentOnce !== undefined) { + servedTrustContent = true; + return route.fulfill({ json: options.trustContentOnce }); + } + return route.fulfill({ json: [] }); + } + if (path === "/admin/workspace") { + return route.fulfill({ + json: { + brand: { id: "brand-current", name: "独立工坊" }, + installations: [], + templateContent: { displayName: "独立创作者画册" }, + offerings: [], + forms: [], + }, + }); + } + if (path === "/admin/releases/readiness") { + return route.fulfill({ json: { ready: true, checks: [] } }); + } + return route.fulfill({ json: [] }); + }); +} + +test("品牌成员接口返回异常结构时显示整页错误而不是白屏", async ({ page }) => { + await page.setViewportSize({ width: 1440, height: 1000 }); + await mockAdminApi(page, { memberships: [{}] }); + + await page.goto(`${adminOrigin}/admin/publication`); + + await expect(page.getByText("页面渲染出错")).toBeVisible(); + await expect(page.getByText(/错误编号:admin-/)).toBeVisible(); + await expect(page.getByRole("button", { name: "重新加载页面" })).toBeVisible(); + await expect(page.getByRole("link", { name: "返回概览" })).toBeVisible(); + + const bodyText = await page.locator("body").innerText(); + expect(bodyText.trim().length).toBeGreaterThan(0); +}); + +test("内容区渲染出错时保留导航,重新加载后恢复", async ({ page }) => { + await page.setViewportSize({ width: 1440, height: 1000 }); + await mockAdminApi(page, { trustContentOnce: [null] }); + + await page.goto(`${adminOrigin}/admin/trust`); + + await expect(page.getByText("页面渲染出错")).toBeVisible(); + await expect(page.getByText(/错误编号:admin-/)).toBeVisible(); + + // 外壳导航仍然可用,不会因为单个页面崩溃而整站白屏 + await expect(page.getByRole("button", { name: "退出登录" })).toBeVisible(); + await expect(page.getByText("内容与发布")).toBeVisible(); + + // 重试仍失败时继续展示错误页,而不是变回白屏 + await page.getByRole("button", { name: /重\s*试/ }).click(); + await expect(page.getByText("页面渲染出错")).toBeVisible(); + + await page.getByRole("button", { name: "重新加载页面" }).click(); + await expect(page.getByRole("heading", { name: "信任内容" })).toBeVisible(); + await expect(page.getByText("页面渲染出错")).toBeHidden(); +});