221 lines
7.8 KiB
TypeScript
221 lines
7.8 KiB
TypeScript
import assert from "node:assert/strict";
|
|
import { test, expect, type Page, type Route } from "@playwright/test";
|
|
|
|
const adminOrigin = process.env.ADMIN_URL || "http://localhost:3005";
|
|
|
|
const pageErrors = new WeakMap<Page, string[]>();
|
|
|
|
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;
|
|
/** 品牌名称的异常返回 */
|
|
brandName?: unknown;
|
|
/** 始终返回的异常信任内容,用于验证契约错误态 */
|
|
trustContent?: unknown;
|
|
/** 只在首次请求时返回的异常信任内容,重新加载后恢复 */
|
|
trustContentOnce?: unknown;
|
|
/** 只在首次请求时返回的异常工作区数据,用于触发渲染异常 */
|
|
workspaceOnce?: unknown;
|
|
/** 上报接口返回的状态码 */
|
|
clientErrorStatus?: number;
|
|
}
|
|
|
|
type ClientErrorReport = {
|
|
errorId?: string;
|
|
message?: string;
|
|
route?: string;
|
|
componentStack?: string;
|
|
};
|
|
|
|
async function mockAdminApi(page: Page, options: MockOptions = {}) {
|
|
let servedTrustContent = false;
|
|
let servedWorkspace = false;
|
|
const clientErrors: ClientErrorReport[] = [];
|
|
|
|
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: options.brandName ?? "独立工坊",
|
|
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 (options.trustContent !== undefined) {
|
|
return route.fulfill({ json: options.trustContent });
|
|
}
|
|
if (!servedTrustContent && options.trustContentOnce !== undefined) {
|
|
servedTrustContent = true;
|
|
return route.fulfill({ json: options.trustContentOnce });
|
|
}
|
|
return route.fulfill({ json: [] });
|
|
}
|
|
if (path === "/admin/client-errors" && method === "POST") {
|
|
clientErrors.push(JSON.parse(request.postData() ?? "{}") as ClientErrorReport);
|
|
return route.fulfill({
|
|
status: options.clientErrorStatus ?? 201,
|
|
...(options.clientErrorStatus && options.clientErrorStatus >= 400
|
|
? {
|
|
json: {
|
|
data: null,
|
|
error: { code: "HTTP_500", message: "上报失败" },
|
|
requestId: "req-client-error",
|
|
},
|
|
}
|
|
: { json: { received: true, duplicate: false } }),
|
|
});
|
|
}
|
|
if (path === "/admin/workspace") {
|
|
if (!servedWorkspace && options.workspaceOnce !== undefined) {
|
|
servedWorkspace = true;
|
|
return route.fulfill({ json: options.workspaceOnce });
|
|
}
|
|
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: [] });
|
|
});
|
|
|
|
return { clientErrors };
|
|
}
|
|
|
|
test("品牌成员与品牌名称异常时后台外壳仍可正常使用", async ({ page }) => {
|
|
await page.setViewportSize({ width: 1440, height: 1000 });
|
|
await mockAdminApi(page, {
|
|
memberships: [{}, null, { brand: { id: "brand-current" } }],
|
|
brandName: { unexpected: true },
|
|
});
|
|
|
|
await page.goto(`${adminOrigin}/admin/publication`);
|
|
|
|
await expect(page.getByRole("heading", { name: "内容与发布" })).toBeVisible();
|
|
await expect(page.getByText("当前品牌", { exact: true }).first()).toBeVisible();
|
|
await expect(page.getByText("页面渲染出错")).toBeHidden();
|
|
await expect(page.getByRole("button", { name: "退出登录" })).toBeVisible();
|
|
});
|
|
|
|
test("内容区渲染出错时上报错误编号并保留导航,重新加载后恢复", async ({ page }) => {
|
|
await page.setViewportSize({ width: 1440, height: 1000 });
|
|
const { clientErrors } = await mockAdminApi(page, {
|
|
workspaceOnce: {
|
|
brand: { id: "brand-current", name: "独立工坊" },
|
|
installations: [],
|
|
templateContent: { displayName: "独立创作者画册", trustContentTypes: [null] },
|
|
offerings: [],
|
|
forms: [],
|
|
},
|
|
});
|
|
|
|
await page.goto(`${adminOrigin}/admin/trust`);
|
|
|
|
await expect(page.getByText("页面渲染出错")).toBeVisible();
|
|
await expect(page.getByText(/错误编号:admin-/)).toBeVisible();
|
|
await expect.poll(() => clientErrors.length).toBe(1);
|
|
const report = clientErrors[0];
|
|
assert.match(report?.errorId ?? "", /^admin-/);
|
|
assert.equal(report?.route, "/admin/trust");
|
|
assert.ok(report?.message);
|
|
|
|
// 外壳导航仍然可用,不会因为单个页面崩溃而整站白屏
|
|
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();
|
|
});
|
|
|
|
test("响应契约不符时展示可读错误,不进入渲染错误边界", async ({ page }) => {
|
|
await page.setViewportSize({ width: 1440, height: 1000 });
|
|
const { clientErrors } = await mockAdminApi(page, { trustContent: [null] });
|
|
|
|
await page.goto(`${adminOrigin}/admin/trust`);
|
|
|
|
await expect(page.getByRole("alert")).toContainText("接口返回数据结构不符合契约");
|
|
await expect(page.getByRole("alert")).toContainText("/admin/config/trust-content");
|
|
await expect(page.getByText("页面渲染出错")).toBeHidden();
|
|
assert.equal(clientErrors.length, 0);
|
|
});
|
|
|
|
test("错误上报失败时错误页仍然可用", async ({ page }) => {
|
|
await page.setViewportSize({ width: 1440, height: 1000 });
|
|
const { clientErrors } = await mockAdminApi(page, {
|
|
clientErrorStatus: 500,
|
|
workspaceOnce: {
|
|
brand: { id: "brand-current", name: "独立工坊" },
|
|
installations: [],
|
|
templateContent: { displayName: "独立创作者画册", trustContentTypes: [null] },
|
|
offerings: [],
|
|
forms: [],
|
|
},
|
|
});
|
|
|
|
await page.goto(`${adminOrigin}/admin/trust`);
|
|
|
|
await expect(page.getByText("页面渲染出错")).toBeVisible();
|
|
await expect(page.getByRole("button", { name: "重新加载页面" })).toBeVisible();
|
|
await expect.poll(() => clientErrors.length).toBe(1);
|
|
// 上报失败不会让错误页递归崩溃,也不会产生未捕获异常
|
|
await page.waitForTimeout(300);
|
|
await expect(page.getByText("页面渲染出错")).toBeVisible();
|
|
});
|