mirror of
https://github.com/Comfy-Org/ComfyUI_frontend.git
synced 2026-02-01 13:59:54 +00:00
fabcbaec82
* Restore backend state when Playwright test finishes. Resolve #1094 * Add warning when env var not set * Rename and replace with scaffolding option for models dir * Rename * Define another env var [skip ci] * Fix paths [skip ci] * Update README.md --------- Co-authored-by: Chenlei Hu <huchenlei@proton.me>
50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
# Playwright Testing for ComfyUI_frontend
|
|
|
|
This document outlines the setup and usage of Playwright for testing the ComfyUI_frontend project.
|
|
|
|
## WARNING
|
|
|
|
The browser tests will change the ComfyUI backend state, such as user settings and saved workflows.
|
|
If `TEST_COMFYUI_DIR` in `.env` isn't set to your `(Comfy Path)/ComfyUI` directory, these changes won't be automatically restored.
|
|
|
|
## Setup
|
|
|
|
Clone <https://github.com/Comfy-Org/ComfyUI_devtools> to your `custom_nodes` directory.
|
|
ComfyUI_devtools adds additional API endpoints and nodes to ComfyUI for browser testing.
|
|
|
|
Ensure you have Node.js v20 or later installed. Then, set up the Chromium test driver:
|
|
|
|
```bash
|
|
npx playwright install chromium --with-deps
|
|
```
|
|
|
|
## Running Tests
|
|
|
|
There are two ways to run the tests:
|
|
|
|
1. **Headless mode with report generation:**
|
|
```bash
|
|
npx playwright test
|
|
```
|
|
This runs all tests without a visible browser and generates a comprehensive test report.
|
|
|
|
2. **UI mode for interactive testing:**
|
|
```bash
|
|
npx playwright test --ui
|
|
```
|
|
This opens a user interface where you can select specific tests to run and inspect the test execution timeline.
|
|
|
|
|
|
|
|
## Screenshot Expectations
|
|
|
|
Due to variations in system font rendering, screenshot expectations are platform-specific. Please note:
|
|
|
|
- We maintain Linux screenshot expectations as our GitHub Action runner operates in a Linux environment.
|
|
- To set new test expectations:
|
|
1. Create a pull request from a `Comfy-Org/ComfyUI_frontend` branch.
|
|
2. Add the `New Browser Test Expectation` tag to your pull request.
|
|
3. This will trigger a GitHub action to update the screenshot expectations automatically.
|
|
|
|
> **Note:** If you're making a pull request from a forked repository, the GitHub action won't be able to commit updated screenshot expectations directly to your PR branch.
|