pcbjam/tests/kicad/eeschema-perf.spec.ts
Viktor Vaczi 4c3a4cacd4 test(determinism): deterministic waits + stableShot screenshots; drop blind sleeps/ifs/retries
Make the Playwright e2e + kicad suites deterministic so screenshot flake stops
tracing to timing races.

- Blind page.waitForTimeout -> condition waits (expect.poll, web-first
  assertions, waitUntil) + readiness helpers (waitForWxApp, waitForCanvasApp).
  Remaining sleeps are documented interaction dwells (annotated).
- Defensive "if element exists" branches -> loud asserts; label-fallback chains
  -> normalized clickMenuItemByText. First-run wizard for/if loops removed by
  seeding calculator/gerbview/pcbnew HTMLs.
- Screenshots: new stableShot(page, name) settles the render in-page (canvas
  hash over rAF) then writes a raw PNG to test-results/ for the existing offline
  gate (tools/screenshots vs baseline-screenshots). Replaces toHaveScreenshot,
  which did inline compare + its own baselines and had decoupled the specs from
  the real gate. scale:'css' pinned.
- retries: 0 in both configs.
- Guard: tests/tools/lint-determinism.ts (npm run lint:determinism) bans blind
  sleeps / toHaveScreenshot / inline retries / swallowed catches in specs;
  documented exceptions carry a marker. Rules in tests/TESTING.md.

Assertions, coverage, and renders unchanged (semantic-equivalence reviewed;
captures pixel-identical modulo inherent timer/timestamp/3d-raytrace variance).
Both suites green at retries:0 (e2e 340, kicad 92); ~35-61% faster.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BVX1pHMvRPYHdp6ZfEawrk
2026-07-07 10:50:24 +02:00

47 lines
2.2 KiB
TypeScript

import { test, expect } from './fixtures';
import * as path from 'path';
import { measureLoad, measureOpenRender, measureFps, setThrottle, recordPerf } from './utils/perf-utils';
/**
* eeschema runtime-perf (TRACK-ONLY, no gating).
*
* Measures the CURRENT build: cold load, open+render of the demo schematic, and
* sustained pan/zoom FPS across CPU-throttle rates. Numbers are logged and written
* to tests/test-results/perf-eeschema.json (CI uploads it). The only assertions are
* "the app booted and the doc opened" — never a perf threshold (would flake CI).
* Runs on the Chromium 'perf' project (CDP throttling); pass --headed for real-GPU FPS.
* Note: on headless/SwiftShader CI, FPS is CPU-bound and noisy — openMs is the stable metric.
*/
const THROTTLES = (process.env.PERF_THROTTLES || '1,4,6').split(',').map(Number);
const FPS_SECS = parseInt(process.env.PERF_FPS_SECS || '6', 10);
const DEMO = path.join(__dirname, '..', 'fixtures', 'demo', 'demo.kicad_sch');
test.describe('eeschema perf', () => {
test('load + open+render + FPS (track-only)', async ({ page, testLogger }) => {
test.setTimeout(300000);
const loadMs = await measureLoad(page, '/kicad/eeschema.html');
console.log(`[perf] eeschema cold load = ${loadMs} ms`);
const openMs = await measureOpenRender(page, DEMO, 'schematic', testLogger);
console.log(`[perf] eeschema open+render = ${openMs} ms`);
await page.keyboard.press('Escape').catch(() => {}); // eslint-disable-line -- best-effort Escape (may not apply in all states)
const cdp = await page.context().newCDPSession(page);
const fps: { throttle: number; fps: number }[] = [];
for (const rate of THROTTLES) {
await setThrottle(cdp, rate);
const f = await measureFps(page, FPS_SECS);
console.log(`[perf] eeschema FPS @ ${rate}x = ${f}`);
fps.push({ throttle: rate, fps: f });
}
await setThrottle(cdp, 1);
recordPerf('eeschema', { loadMs, openMs, fps });
// Track-only: assert only that it booted + opened.
expect(loadMs).toBeGreaterThan(0);
expect(openMs).toBeGreaterThan(0);
});
});