import { test, expect, Page } from './fixtures'; test.describe.configure({ mode: 'parallel' }); // dev 指示器 的剥离已上移到 e2e/fixtures.ts 的 context 夹具,全站所有 project 共用。 // 基线口径固定为「用户已表达 Cookie 偏好」。同意条由 2s 定时器后才渲染,慢引擎(firefox / webkit) // 会在截图前把它画进首屏底部,快引擎(chromium)则赶不上 —— 这是与引擎速度相关的竞态, // 且这两个 project 为规避 newContext 兼容噪声而使用空 storageState(见 5a4d310),拿不到预置偏好。 // 时间戳取常量而非 Date.now(),避免基线随采集日漂移。 test.beforeEach(async ({ page }) => { await page.addInitScript(() => { localStorage.setItem( 'novalon-cookie-preferences', JSON.stringify({ necessary: true, analytics: false, marketing: false, functionality: true, timestamp: 1784284000000, }), ); }); }); const VISUAL_TEST_PAGES = [ { path: '/', name: 'home', label: '首页' }, { path: '/about', name: 'about', label: '关于我们' }, { path: '/contact', name: 'contact', label: '联系我们' }, { path: '/products', name: 'products', label: '产品中心' }, { path: '/products/erp', name: 'product-erp', label: '产品详情-ERP' }, // 与 /products/erp 是不同路由:此前只在 Lighthouse URL 表里,视觉表缺它 ⇒ 同型覆盖缺口(验收 §8 限制⑦) { path: '/products/erp-upgrade', name: 'product-erp-upgrade', label: '产品 ERP 升级页' }, { path: '/about/brand', name: 'about-brand', label: '品牌资产页' }, { path: '/solutions', name: 'solutions', label: '解决方案列表' }, { path: '/solutions/manufacturing', name: 'solution-manufacturing', label: '解决方案详情-制造' }, { path: '/services', name: 'services', label: '服务列表' }, { path: '/services/software', name: 'service-software', label: '服务详情-软件开发' }, { path: '/news', name: 'news', label: '新闻列表' }, { path: '/news/company-founded', name: 'news-detail', label: '新闻详情' }, { path: '/team', name: 'team', label: '团队介绍' }, { path: '/methodology', name: 'methodology', label: '方法论' }, ]; async function waitForPageStable(page: Page) { await page.waitForLoadState('networkidle'); await page.waitForTimeout(2000); // 触发全页 ScrollReveal / StaggerReveal:逐屏滚到底再回顶,让所有 below-the-fold // 模块的 whileInView 动画进入最终态,避免全页截图时内容停在 opacity:0 初始态。 // 不能直接 `scrollTo(scrollHeight)` 一跳到底:IntersectionObserver 只会回调当前视口 // 内的目标,中间各屏被跳过 ⇒ 截图出来是空白段(2026-10-20 移除路由级 AnimatePresence // 后首屏不再替子树屏蔽 initial,这条路径才真正被走到)。 // dwell 由 120ms 提到 260ms 并排掉两帧:120ms 在 4 worker 抢 CPU 时不足以让 // IO 回调 + framer 提交动画,中间某屏会被跳过(lessons §5.51)。 await page.evaluate(async () => { const nextFrame = () => new Promise((resolve) => requestAnimationFrame(() => requestAnimationFrame(() => resolve()))); const step = Math.max(400, Math.floor(window.innerHeight * 0.8)); for (let y = 0; y <= document.body.scrollHeight; y += step) { window.scrollTo({ top: y, behavior: 'instant' }); await new Promise((resolve) => setTimeout(resolve, 260)); await nextFrame(); } window.scrollTo({ top: document.body.scrollHeight, behavior: 'instant' }); await new Promise((resolve) => setTimeout(resolve, 400)); window.scrollTo({ top: 0, behavior: 'instant' }); await new Promise((resolve) => setTimeout(resolve, 200)); }); await page.evaluate(() => { document.querySelectorAll('img').forEach(img => { if (!img.complete) { img.loading = 'eager'; } }); }); await page.waitForTimeout(1000); await page.evaluate(() => document.fonts?.ready); await page.waitForTimeout(500); await assertCmsStateOk(page); await waitForRevealsSettled(page); } /** * 等 whileInView 真正提交:framer 把未开始的动画写成 inline `opacity: 0`, * 完成后改写成 1。两者只差这一笔,所以按 inline style 判定即可。 * 排除 display:none 与零高度元素(折叠菜单、屏外测距节点),避免把「本来就不可见」判成未提交。 * 表达式以字符串传入:它在浏览器上下文求值,闭包里的 Node 侧变量带不过去。 */ const PENDING_REVEALS_EXPR = "Array.from(document.querySelectorAll('main *')).filter((el) => el.style.opacity === '0' && getComputedStyle(el).display !== 'none' && el.getBoundingClientRect().height > 0)"; async function waitForRevealsSettled(page: Page) { try { await page.waitForFunction(`${PENDING_REVEALS_EXPR}.length === 0`, undefined, { timeout: 8000, polling: 100, }); } catch { const total: number = await page.evaluate(`${PENDING_REVEALS_EXPR}.length`); const pending: string[] = await page.evaluate( `${PENDING_REVEALS_EXPR}.slice(0, 5).map((el) => el.tagName.toLowerCase() + '.' + String(el.className).split(' ').slice(0, 2).join('.'))`, ); throw new Error( `${total} 个元素仍停在 inline opacity:0(whileInView 未提交):${pending.join(' , ')}`, ); } } /** * 首页把 CMS 读数状态写在 `data-cms-state` 上。退化时页面照常 200、只是整套落到常量版式, * 像素比对只会给出一团无从归因的差异 —— 在这里先按名字判一次。 * 首页**必须有**这个标记:标记消失(改坏 prop / 改回旧组件)时不能静默放行, * 否则这条守卫会退化成永不生效的死判据。其它页面不标,跳过。 */ async function assertCmsStateOk(page: Page) { const isHome = new URL(page.url()).pathname === '/'; if (!isHome) return; const marker = page.locator('main [data-cms-state]').first(); if ((await marker.count()) === 0) { throw new Error('首页缺少 data-cms-state 标记:CMS 退化守卫已失效(见 lessons §5.51)'); } const state = await marker.getAttribute('data-cms-state'); if (state !== 'ok') { throw new Error( `CMS 数据退化:data-cms-state=${state};页面已回落到常量版式,像素比对无意义(lessons §5.51)`, ); } } test.describe('L1: 全页面视觉回归测试', () => { test.setTimeout(60000); for (const { path, name, label } of VISUAL_TEST_PAGES) { test(`${label} (${path}) - 全页截图对比`, async ({ page }) => { await page.goto(path, { waitUntil: 'domcontentloaded' }); await waitForPageStable(page); await expect(page).toHaveScreenshot(`${name}-fullpage.png`, { fullPage: true, animations: 'disabled', caret: 'hide', }); }); } }); test.describe('L2: 组件视觉状态测试', () => { test.setTimeout(45000); test('按钮组件 - 默认/悬停/聚焦状态', async ({ page }) => { await page.goto('/', { waitUntil: 'domcontentloaded' }); await waitForPageStable(page); // N-15(c) 诊断结论:**装配缺陷,不是产品缺陷**。 // 旧选择器 `button, a[role="button"]` 的 .first() 取的是 DOM 序第一个