// 前端全页面冒烟:登录 → 逐个路由打开 → 页面渲染出来、无控制台错误 / 未捕获异常 / 失败的 API 请求 → 截图。 // // 前置:后端与 web 已启动,管理员已初始化(见 README「前端冒烟」)。 // SMOKE_BASE_URL web 地址,缺省 http://127.0.0.1:5180(dev 代理 /api 到后端;单容器部署直接用 4380) // SMOKE_USER 管理员用户名(必填) // SMOKE_PASSWORD 管理员密码(必填) // SMOKE_OUT 截图目录,缺省 apps/web/test/screenshots/smoke(已 gitignore) // SMOKE_CHROMIUM 浏览器可执行文件,缺省 /usr/bin/chromium → /usr/bin/google-chrome // SMOKE_SCREENSHOTS=0 不截图 // 退出码:全部通过 0,有失败 1,前置条件不满足 2。 import { existsSync, mkdirSync } from "node:fs"; import { join, resolve } from "node:path"; import process from "node:process"; import { chromium } from "playwright-core"; const BASE = (process.env.SMOKE_BASE_URL ?? "http://127.0.0.1:5180").replace(/\/+$/, ""); const USER = process.env.SMOKE_USER ?? ""; const PASSWORD = process.env.SMOKE_PASSWORD ?? ""; const OUT = resolve(process.env.SMOKE_OUT ?? join(import.meta.dirname, "../test/screenshots/smoke")); const SHOTS = process.env.SMOKE_SCREENSHOTS !== "0"; /** 静态路由 + 需要真实 ID 的详情路由(从列表接口取第一条;没有数据时跳过) */ const STATIC_ROUTES = [ "/console", "/console/inbox", "/console/library", "/console/identity", "/console/organize", "/console/files", "/console/files/trash", "/console/subscriptions", "/console/rules", "/console/preferences", "/console/sites", "/console/sources", "/console/downloads", "/console/downloads/plans", "/console/tasks", "/console/agent", "/console/agent?mock=1", "/console/engine", "/console/audit", "/console/schedules", "/console/settings", "/console/settings?tab=pi", ]; const DETAIL_ROUTES = [ { route: "/console/library/:id", list: "/api/v1/library" }, { route: "/console/organize/:id", list: "/api/v1/organization-records" }, { route: "/console/sites/:id", list: "/api/v1/sites" }, { route: "/console/sites/:id", list: "/api/v1/sites", after: "?tab=snapshots" }, { route: "/console/sites/:id", list: "/api/v1/sites", after: "?tab=accounts" }, { route: "/console/downloads/:id", list: "/api/v1/download-tasks" }, { route: "/console/tasks/:id", list: "/api/v1/tasks" }, { route: "/console/agent/:id", list: "/api/v1/agent/runs", after: "?mock=0" }, { route: "/console/engine/:id", list: "/api/v1/engine/runs" }, ]; /** * IA 重构后的旧链接(docs/design/console-ia.md §3.3):打开旧地址,最终落到新地址且页面 200。 * 与 app/routes/console/redirects.ts 的 LEGACY_REDIRECTS 同步;:id 从列表接口取。 */ const REDIRECT_ROUTES = [ { from: "/console/tasks?tab=downloads", to: "/console/downloads" }, { from: "/console/tasks?tab=downloads&status=paused", to: "/console/downloads?status=paused" }, { from: "/console/tasks?tab=plans", to: "/console/downloads/plans" }, { from: "/console/tasks?tab=tasks", to: "/console/tasks" }, { from: "/console/subscriptions?tab=policies", to: "/console/rules" }, { from: "/console/sources?tab=snapshots", to: "/console/sources" }, { from: "/console/sources?tab=snapshots&siteId=:id", to: "/console/sites/:id?tab=snapshots", list: "/api/v1/sites" }, // 旧的下载详情地址:先查业务任务(404 属预期),再跳到下载详情 { from: "/console/tasks/:id", to: "/console/downloads/:id", list: "/api/v1/download-tasks", expect404: true }, ]; /** 允许的控制台噪音(React Router 开发模式提示等,不算错误) */ const IGNORED = [/Download the React DevTools/i, /React Router Future Flag Warning/i]; function pickBrowser() { const cands = [process.env.SMOKE_CHROMIUM, "/usr/bin/chromium", "/usr/bin/google-chrome"].filter(Boolean); return cands.find((p) => existsSync(p)); } async function main() { if (!USER || !PASSWORD) { console.error("缺少 SMOKE_USER / SMOKE_PASSWORD(已初始化的管理员账号)"); process.exit(2); } const executablePath = pickBrowser(); if (!executablePath) { console.error("找不到浏览器:设置 SMOKE_CHROMIUM 指向 chromium / chrome 可执行文件"); process.exit(2); } if (SHOTS) mkdirSync(OUT, { recursive: true }); const browser = await chromium.launch({ executablePath, headless: true, args: ["--no-sandbox"] }); const context = await browser.newContext({ viewport: { width: 1440, height: 900 }, locale: "zh-CN" }); const page = await context.newPage(); /** 当前路由收集到的问题 */ let problems = []; page.on("console", (m) => { if (m.type() !== "error") return; const text = m.text(); if (IGNORED.some((r) => r.test(text))) return; problems.push(`console.error: ${text.slice(0, 300)}`); }); page.on("pageerror", (e) => problems.push(`pageerror: ${String(e.message ?? e).slice(0, 300)}`)); page.on("response", (r) => { const url = r.url(); if (!url.includes("/api/")) return; // /events 是 SSE 长连接;401 探测(/auth/session)不算 if (url.includes("/api/v1/events")) return; if (r.status() >= 400 && !(r.status() === 401 && url.includes("/auth/session"))) problems.push(`HTTP ${r.status()} ${r.request().method()} ${url.replace(BASE, "")}`); }); // ── 登录 ── const loginRes = await page.goto(`${BASE}/login`, { waitUntil: "networkidle" }); if (loginRes?.status() !== 200) { console.error(`登录页不可达:${BASE}/login → ${loginRes?.status()}`); await browser.close(); process.exit(2); } await page.fill("#username", USER); await page.fill("#password", PASSWORD); await page.click('button[type="submit"]'); try { await page.waitForURL((u) => u.pathname.startsWith("/console"), { timeout: 15_000 }); } catch { console.error("登录失败(没有跳到 /console),检查账号密码或后端是否启动"); if (SHOTS) await page.screenshot({ path: join(OUT, "login-failed.png"), fullPage: true }); await browser.close(); process.exit(2); } problems = []; // ── 详情路由取真实 ID ── const routes = [...STATIC_ROUTES]; const skipped = []; for (const d of DETAIL_ROUTES) { const r = await page.request.get(`${BASE}${d.list}?limit=1`); const body = r.ok() ? await r.json().catch(() => null) : null; const id = body?.data?.items?.[0]?.id ?? body?.data?.items?.[0]?.entity?.id; if (id) routes.push(d.route.replace(":id", encodeURIComponent(id)) + (d.after ?? "")); else skipped.push(`${d.route}(${d.list} 无数据)`); } // ── 逐个路由 ── const results = []; for (const path of routes) { problems = []; const t0 = Date.now(); let status = 0; try { const res = await page.goto(`${BASE}${path}`, { waitUntil: "networkidle", timeout: 30_000 }); status = res?.status() ?? 0; // SPA 外壳已渲染(主内容区出现),不是登录页 / 404 页 await page.waitForSelector("main", { timeout: 10_000 }); await page.waitForTimeout(400); if (new URL(page.url()).pathname === "/login") problems.push("被重定向到登录页"); const notFound = await page.locator("text=页面不存在").count(); if (notFound) problems.push("渲染成 404 页"); } catch (err) { problems.push(`加载失败:${String(err?.message ?? err).split("\n")[0]}`); } if (status !== 200) problems.push(`HTTP ${status}`); const name = path.replace(/^\/console\/?/, "").replace(/[/?=&:]+/g, "_") || "home"; if (SHOTS) await page.screenshot({ path: join(OUT, `${name}.png`), fullPage: true }).catch(() => {}); results.push({ path, ms: Date.now() - t0, problems: [...new Set(problems)] }); } // ── 旧链接重定向 ── for (const r of REDIRECT_ROUTES) { let from = r.from; let to = r.to; if (r.list) { const res = await page.request.get(`${BASE}${r.list}?limit=1`); const id = res.ok() ? (await res.json().catch(() => null))?.data?.items?.[0]?.id : null; if (!id) { skipped.push(`${r.from}(${r.list} 无数据)`); continue; } from = from.replace(":id", encodeURIComponent(id)); to = to.replace(":id", encodeURIComponent(id)); } problems = []; const t0 = Date.now(); let status = 0; try { const res = await page.goto(`${BASE}${from}`, { waitUntil: "networkidle", timeout: 30_000 }); status = res?.status() ?? 0; await page.waitForURL((u) => `${u.pathname}${u.search}` === to, { timeout: 10_000 }); await page.waitForSelector("main", { timeout: 10_000 }); } catch (err) { const u = new URL(page.url()); problems.push(`没有跳到 ${to}(停在 ${u.pathname}${u.search}):${String(err?.message ?? err).split("\n")[0]}`); } if (status !== 200) problems.push(`HTTP ${status}`); // 旧下载详情先探测业务任务,那次 404 与浏览器随之打印的资源错误是预期内的 const kept = r.expect404 ? problems.filter((p) => !/404/.test(p)) : problems; results.push({ path: `${from} → ${to}`, ms: Date.now() - t0, problems: [...new Set(kept)] }); } await browser.close(); // ── 汇报 ── let failed = 0; for (const r of results) { const ok = r.problems.length === 0; if (!ok) failed++; console.log(`${ok ? "PASS" : "FAIL"} ${r.path} (${r.ms}ms)`); for (const p of r.problems) console.log(` - ${p}`); } for (const s of skipped) console.log(`SKIP ${s}`); console.log( `\n${results.length - failed}/${results.length} 通过${skipped.length ? `,跳过 ${skipped.length}` : ""}${SHOTS ? `;截图:${OUT}` : ""}`, ); process.exit(failed ? 1 : 0); } main().catch((err) => { console.error(err); process.exit(1); });