pcbjam/tests/e2e/wizard.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

86 lines
3.6 KiB
TypeScript

// wxWizard Tests - Footprint Wizard simulation
import { test, expect, waitForWxApp } from './utils/fixtures';
import { clickByLabel, waitForElement, stableShot } from './utils/element-tracker';
test.describe('wxWizard Tests', () => {
test('Wizard test app loads successfully', async ({ page, testLogger }) => {
await page.goto('/standalone/wizard/wizard_test.html');
await waitForWxApp(page);
await stableShot(page, 'wizard-01-loaded.png', { fullPage: true });
expect(testLogger.errors.filter(e => !e.includes('favicon'))).toHaveLength(0);
});
test('Wizard dialog can be launched', async ({ page }) => {
await page.goto('/standalone/wizard/wizard_test.html');
await waitForWxApp(page);
// Click Launch button using element registry
await waitForElement(page, 'Launch Footprint Wizard');
const clicked = await clickByLabel(page, 'Launch Footprint Wizard');
expect(clicked, 'Launch Wizard button should be found and clicked').toBe(true);
await stableShot(page, 'wizard-02-launch.png', { fullPage: true });
});
test('Wizard can navigate to next page', async ({ page }) => {
await page.goto('/standalone/wizard/wizard_test.html');
await waitForWxApp(page);
// Launch wizard using element registry
await waitForElement(page, 'Launch Footprint Wizard');
const launchClicked = await clickByLabel(page, 'Launch Footprint Wizard');
expect(launchClicked, 'Launch Wizard button should be found').toBe(true);
// Click Next using element registry
await waitForElement(page, 'Next');
const nextClicked = await clickByLabel(page, 'Next');
expect(nextClicked, 'Next button should be found and clicked').toBe(true);
await stableShot(page, 'wizard-03-next-page.png', { fullPage: true });
});
test('Wizard can navigate back', async ({ page }) => {
await page.goto('/standalone/wizard/wizard_test.html');
await waitForWxApp(page);
// Launch wizard using element registry
await waitForElement(page, 'Launch Footprint Wizard');
const launchClicked = await clickByLabel(page, 'Launch Footprint Wizard');
expect(launchClicked, 'Launch Wizard button should be found').toBe(true);
// Click Next using element registry
await waitForElement(page, 'Next');
const nextClicked = await clickByLabel(page, 'Next');
expect(nextClicked, 'Next button should be found').toBe(true);
// Let the Next page-transition commit before clicking Back (the Back/Next
// buttons persist across pages, so there is no registry delta to poll on).
await page.waitForTimeout(200); // eslint-disable-line -- documented interaction dwell
// Click Back using element registry
const backClicked = await clickByLabel(page, 'Back');
expect(backClicked, 'Back button should be found and clicked').toBe(true);
await stableShot(page, 'wizard-04-back-page.png', { fullPage: true });
});
test('Wizard can be cancelled', async ({ page }) => {
await page.goto('/standalone/wizard/wizard_test.html');
await waitForWxApp(page);
// Launch wizard using element registry
await waitForElement(page, 'Launch Footprint Wizard');
const launchClicked = await clickByLabel(page, 'Launch Footprint Wizard');
expect(launchClicked, 'Launch Wizard button should be found').toBe(true);
// Click Cancel using element registry
await waitForElement(page, 'Cancel');
const cancelClicked = await clickByLabel(page, 'Cancel');
expect(cancelClicked, 'Cancel button should be found and clicked').toBe(true);
await stableShot(page, 'wizard-05-cancel.png', { fullPage: true });
});
});