Skip to content

Add testing guidance on snapshots and waitFor to AGENTS.md #5885

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Eugene (OEvgeny) merged 2 commits into from
Oct 17, 2026
Merged

Add testing guidance on snapshots and waitFor to AGENTS.md #5885

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
175183e
Add testing guidance on snapshots and waitFor to AGENTS.md
Oct 17, 2026
b48d9ed
Merge branch 'main' into OEvgeny/dev-agents-md-testing-guidance
OEvgeny Oct 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,8 @@ export { MyComponentPropsSchema, type MyComponentProps };
- Follow other HTML files under the same folder on how to write tests
- Page conditions, page elements, and page objects can be found at `/packages/test/page-object/src/globals`
- Use `expect` instead of `assert`
- For visual changes, let snapshots (VRT) do the work instead of asserting computed CSS, assert state such as focus, role, name, and attributes
- Wait for effects of asynchronous work (e.g. after `host.click()`) with `waitFor()` from `@testduet/wait-for` and `expect`, not with sleeps
- Use `@testduet/given-when-then` package instead of xUnit style `describe`/`before`/`test`/`after`
- Prefer integration/end-to-end testing than unit testing
- Use as realistic setup as possible, such as using `msw` than mocking calls
Expand Down
Loading