Files
novalon-website/e2e/visual-regression.spec.ts
zhangxiang ec30f508fa test(visual): 截图前等显影落定,dwell 120ms→260ms 并排两帧
旧 helper 只靠固定 120ms 步长等 whileInView 提交,4 worker 抢 CPU 时中间某屏会被
IO 回调漏掉,截图留下一条 opacity:0 的空白带(lessons §5.51 签名 1)。这是装配竞态,
不该靠「多等一会儿」赌,也不该把整层钉成 --workers=1 用串行遮掉。

- 每步 dwell 提到 260ms 并排两帧(rAF×2)后再进下一屏。
- 滚动结束后等**状态**而不是时长:`main` 下 inline `opacity:0` 且仍有高度的元素必须
  归零;8s 超时则把前 5 个 offender 的标签写进错误,让红按名字出现。
  判据用 inline style 而非计算样式——framer 未开始时写 `opacity:0`、完成后写 `1`,
  两者只差这一笔;同时排除 display:none 与零高度节点,避免误判折叠菜单。
- 顺带修掉 `document.fonts?.ready` 只取 promise 不 await 的老问题(等于没等字体)。
- 截图前断言首页的 `data-cms-state`:CMS 退化按名字失败,不留给像素比对去猜。
2026-10-21 16:36:49 +08:00

361 lines
17 KiB
TypeScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { test, expect, Page } from './fixtures';
test.describe.configure({ mode: 'parallel' });
// dev 指示器 <nextjs-portal> 的剥离已上移到 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<void>((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、只是整套落到常量版式,
* 像素比对只会给出一团无从归因的差异 —— 在这里先按名字判一次。
*/
async function assertCmsStateOk(page: Page) {
const marker = page.locator('main [data-cms-state]').first();
if ((await marker.count()) === 0) return;
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 序第一个 <button>,即桌面导航的
// 「产品」下拉触发器;它的祖先 <nav class="hidden md:flex …" data-testid="desktop-navigation">
// (src/components/layout/header.tsx:124)在 md(768px) 以下 display:none ⇒ 按设计不可见。
// 实测(同一 fixture:reducedMotion=reduce + 已同意 Cookie + 剥离 nextjs-portal,390x844 iPhone14):
// 匹配总数 4、其中可见 1;.first().isVisible() = false;
// 前 3 个匹配(产品/解决方案下拉 + header.tsx:169 那个 `hidden md:flex` 容器里的主题切换按钮)
// 的祖先链里各有一个 display:none 容器。
// 390px 下页面真正提供的按钮是 src/components/layout/header.tsx:184-196 的
// data-testid="mobile-menu-button"(aria-label="打开菜单"、style minWidth/minHeight 44px),
// 实测盒 44x44 @ (338,10) ⇒ 触控目标达标,导航入口存在 ⇒ 产品侧无缺陷。
// 修法:用 Playwright 的 :visible 伪类过滤,让每个 project 拍到「该视口下第一个真实可见的按钮」。
// 桌面/平板档目标元素不变(那里 .first() 本来就是可见节点,过滤不改变选择结果):
// 实测 1280px 下新选择器盒 = 81x43.98,与现存基线 button-default-visual-chromium-desktop.png 的 81x44 一致。
const primaryBtn = page.locator('button:visible, a[role="button"]:visible').first();
await expect(primaryBtn).toBeVisible();
await expect(primaryBtn).toHaveScreenshot('button-default.png');
await primaryBtn.hover();
await page.waitForTimeout(300);
await expect(primaryBtn).toHaveScreenshot('button-hover.png');
await primaryBtn.focus();
await page.waitForTimeout(200);
await expect(primaryBtn).toHaveScreenshot('button-focus.png');
});
test('导航菜单 - 桌面端视觉', async ({ page }) => {
await page.goto('/', { waitUntil: 'domcontentloaded' });
await waitForPageStable(page);
const header = page.locator('header').first();
await expect(header).toBeVisible();
await expect(header).toHaveScreenshot('header-navigation.png');
});
test('页脚区域 - 视觉一致性', async ({ page }) => {
await page.goto('/', { waitUntil: 'domcontentloaded' });
await waitForPageStable(page);
const footer = page.locator('footer').first();
await expect(footer).toBeVisible();
await expect(footer).toHaveScreenshot('footer-section.png');
});
test('卡片组件 - 视觉样式', async ({ page }) => {
await page.goto('/products', { waitUntil: 'domcontentloaded' });
await waitForPageStable(page);
// N-15(b) 修正:旧选择器 [class*="card"] 在 /products 上匹配 **0 个元素**(实测 1280/834/390 三档
// 视口 count 均为 0)——本页卡片由 BentoItem 渲染,class 只有 Tailwind 的形状/颜色描述
// (`h-full md:col-span-2 lg:col-span-2 …`),不含 "card" 子串 ⇒ 用例在截图之前就死在
// `element(s) not found` 上,5/5 project 恒红,且 product-card.png 从未存在。
// 真实 DOM 的语义锚点:src/components/sections/bento-grid.tsx:48 输出 data-testid,
// 值由 src/app/(marketing)/products/products-content-v3.tsx:105 的
// `bento-product-card-${product.id}` 传入 ⇒ 实测 7 个匹配,首个为 bento-product-card-erp,
// 三档视口均 isVisible()=true(1280px 盒 594.5x791.8)。
const card = page.locator('[data-testid^="bento-product-card-"]').first();
await expect(card).toBeVisible();
// 钉住断言对象确实是 Bento 卡片单元(role="listitem" 的容器),防止选择器再次漂回空匹配
await expect(card).toHaveAttribute('role', 'listitem');
await expect(card).toHaveAttribute('data-bento-size', /.+/);
await expect(card).toHaveScreenshot('product-card.png');
});
/**
* 创始团队观点区(FounderQuote)**反向守卫** —— 2026-10-17 由截图用例改写。
*
* 原用例对 `[data-testid="founder-quote-section"]` 做区域截图。该区块已按 ADR-0008 决策一
* **整块删除**(它是全站唯一 `bg-brand-section #8B1530` 满幅面:实测两家近单色对标里
* 饱和红用作"面"的次数为 **0** —— Porsche 的红出现 4 次全是按钮,
* Bain 的 #CC0000 出现 65 次无一次是面或阴影;两家也都没有 CEO 引言带,那是 Accenture 的语法),
* 于是选择器**永不可能命中** ⇒ 5 个 project 各挂一次 `scrollIntoViewIfNeeded` 超时
* (本轮只读复跑实测:109 failed = 104 例像素不符 + 5 例超时,超时正是这一条 ×5)。
*
* 修法不是给它补一张新基线 —— 那等于为一个"按裁定不该存在的东西"重建参照。
* 改成断言它**确实不在**,并顺带钉住"全站无满幅饱和红面"这条实测语法判据:
* 若将来有人把深红区块加回首页,这里会红。
*/
test('首页不再有创始团队观点区,也没有满幅饱和红面(反向守卫)', async ({ page }) => {
await page.goto('/', { waitUntil: 'domcontentloaded' });
await waitForPageStable(page);
// 区块本体不得复活
await expect(page.locator('[data-testid="founder-quote-section"]')).toHaveCount(0);
// 承载它的满幅饱和红面也不得出现(全站唯一一处已随该区块退役)
await expect(page.locator('.bg-brand-section')).toHaveCount(0);
});
test('表单输入框 - 默认/聚焦状态', async ({ page }) => {
await page.goto('/contact', { waitUntil: 'domcontentloaded' });
await waitForPageStable(page);
// N-15(b) 修正:/contact 上 DOM 序第一个 input[type="text"] 是**反垃圾蜜罐**,它按设计隐藏
// (src/app/(marketing)/contact/contact-content-v3.tsx:431-439:
// style={{ display: 'none' }} + tabIndex={-1} + autoComplete="off" + aria-hidden="true"
// + aria-label="honeypot" + name="website")。
// 旧选择器 `input[type="text"], input[type="email"]` 的 .first() 恰好命中它
// (实测 name="website"、isVisible()=false,5/5 project 恒红,报 Expected: visible / Received: hidden)
// ⇒ 断言对象是一个故意不可见的安全控件,失败是测试错而不是页面坏。
// 蜜罐覆盖**不删**:改为在此单独、显式地断言它的存在与隐藏属性(这才是它真正的契约)。
const honeypot = page.locator('form input[name="website"]');
await expect(honeypot).toHaveCount(1);
await expect(honeypot).toHaveAttribute('type', 'text');
await expect(honeypot).toHaveAttribute('tabindex', '-1');
await expect(honeypot).toHaveAttribute('autocomplete', 'off');
await expect(honeypot).toHaveAttribute('aria-hidden', 'true');
await expect(honeypot).toHaveAttribute('aria-label', 'honeypot');
await expect(honeypot).toBeHidden();
// 可见字段:限定在表单内并用 Playwright 的 :visible 过滤掉蜜罐。
// 实测(1280/834/390 三档一致):form input 共 5 个、可见 4 个,
// 第一个可见者 = <input id="name" name="name" data-testid="name-input">(真实姓名框,
// 由 src/components/ui/input.tsx:29 的 {...props} 透传 testid),蜜罐被自然排除。
const input = page.locator('form input:visible').first();
// 回归护栏:选中的必须是带 name 的真实字段,永不再漂回蜜罐
await expect(input).toHaveAttribute('name', /^(name|email|phone|subject)$/);
await expect(input).not.toHaveAttribute('aria-hidden', 'true');
await expect(input).toBeVisible();
await expect(input).toHaveScreenshot('input-default.png');
await input.click();
await page.waitForTimeout(200);
await expect(input).toHaveScreenshot('input-focused.png');
});
});
test.describe('L2: 主题切换视觉测试', () => {
test.setTimeout(45000);
// 主题由「系统偏好」驱动(默认跟随系统,见 src/lib/theme.ts),因此用 Playwright 的
// colorScheme 上下文选项模拟 OS 偏好,而不是事后 setAttribute:
// 挂载后的 ThemeToggle 会把 html[data-theme] 重置为解析结果,事后改属性存在竞态
// (hydration 晚于 setAttribute 时会被覆盖,深色快照拍成浅色)。
test.describe('系统偏好浅色', () => {
test.use({ colorScheme: 'light' });
test('浅色主题 - 首页视觉', async ({ page }) => {
await page.goto('/', { waitUntil: 'domcontentloaded' });
await waitForPageStable(page);
await expect(page.locator('html')).toHaveAttribute('data-theme', 'light');
await expect(page.locator('main').first()).toHaveScreenshot('theme-light-main.png');
});
});
test.describe('系统偏好深色', () => {
test.use({ colorScheme: 'dark' });
test('深色主题 - 首页视觉', async ({ page }) => {
await page.goto('/', { waitUntil: 'domcontentloaded' });
await waitForPageStable(page);
await expect(page.locator('html')).toHaveAttribute('data-theme', 'dark');
await expect(page.locator('main').first()).toHaveScreenshot('theme-dark-main.png');
});
});
});
test.describe('L3: 排版与色彩验证', () => {
test.setTimeout(30000);
test('首页 H1 标题字体样式', async ({ page }) => {
await page.goto('/', { waitUntil: 'domcontentloaded' });
await waitForPageStable(page);
const h1 = page.locator('h1').first();
await expect(h1).toBeVisible();
const styles = await h1.evaluate(el => {
const computed = window.getComputedStyle(el);
return {
fontSize: computed.fontSize,
fontWeight: computed.fontWeight,
fontFamily: computed.fontFamily,
color: computed.color,
lineHeight: computed.lineHeight,
};
});
const size = parseFloat(styles.fontSize);
expect(isNaN(size)).toBe(false);
expect(size).toBeGreaterThanOrEqual(16);
expect(styles.color).toBeTruthy();
expect(styles.fontFamily).toBeTruthy();
expect(styles.fontWeight).toBeTruthy();
expect(styles.lineHeight).toBeTruthy();
});
test('品牌主色调验证', async ({ page }) => {
await page.goto('/', { waitUntil: 'domcontentloaded' });
await waitForPageStable(page);
const primaryColor = await page.evaluate(() => {
const style = getComputedStyle(document.documentElement);
return {
brand: style.getPropertyValue('--color-brand')?.trim(),
ink: style.getPropertyValue('--color-ink')?.trim(),
bg: style.getPropertyValue('--color-bg-primary')?.trim(),
text: style.getPropertyValue('--color-text-primary')?.trim(),
};
});
// 逐个令牌断言,不用 `a || b` —— 任一令牌缺失即门失效
for (const [token, value] of Object.entries(primaryColor)) {
expect(value, `--color-${token} 未解析出值`).toBeTruthy();
}
});
});