writing-playwright-tests

Start by searching browser_tests/tests/ for similar existing tests and reading the fixtures in browser_tests/fixtures/. Use the comfyPageFixture import, load premade JSON workflow assets with comfyPage.workflow.loadWorkflow(), and follow the quick start template structure.

The most common cause is a missing await comfyPage.nextFrame() after canvas operations, which lets the canvas sync before assertions. Other causes include missing element focus for keyboard shortcuts and platform-specific screenshot differences, since baselines are Linux-only.

Choose based on what you are testing: use comfyPage.vueNodes for Vue-rendered DOM widgets and CSS states, and comfyPage.nodeOps for canvas interactions and connections. Vue nodes require explicitly enabling the Comfy.VueNodes.Enabled setting first.

Do not commit locally generated screenshots since baselines are Linux-only. Add the 'New Browser Test Expectations' label to your PR, and CI will generate and update the expected screenshots automatically.

waitForTimeout introduces arbitrary fixed delays that cause flakiness and slow suites. Use auto-retrying assertions like toBeVisible(), expect.poll() for single values, or expect().toPass() for multiple conditions instead.