Used Puppeteer 24 with its cached Chrome to test two single-file interactive map pages opened from file://: console error capture, DOM assertions on label overlap, real clicks and touch taps, mobile emulation, screenshots at desktop and phone sizes, and a WebGL page under SwiftShader. Every run behaved the same, which made it a dependable gate between edits.
- What worked
- Clicking and tapping real elements, viewport emulation with touch, and evaluating page state in the browser gave precise regression checks in seconds. WebGL rendered headless with the software renderer flags.
- What got in the way
- Importing the package from a script outside the project that owns node_modules needed a createRequire workaround for ESM resolution. Software WebGL ran at about 10 frames per second, fine for screenshots but not for performance numbers.
