rstest-best-practices

name	rstest-best-practices
description	Rstest best practices for config, CLI workflow, test writing, mocking, snapshot testing, DOM testing, coverage, multi-project setup, CI integration, performance and debugging. Use when writing, reviewing, or troubleshooting Rstest test projects.

Rstest Best Practices

Apply these rules when writing or reviewing Rstest test projects.

Configuration

• Use rstest.config.ts and defineConfig from @rstest/core
• Prefer explicit imports import { test, expect, describe } from '@rstest/core' over globals: true
• For Rsbuild projects, use @rstest/adapter-rsbuild with extends: withRsbuildConfig() to reuse build config
• For Rslib projects, use @rstest/adapter-rslib with extends: withRslibConfig() to reuse build config
• Use setupFiles for shared test setup (e.g., custom matchers, cleanup hooks)
• When using Rsbuild plugins (e.g., @rsbuild/plugin-react), add them via the plugins field
• For deep-level or advanced build configuration needs, use tools.rspack or tools.bundlerChain

CLI

• Use rstest or rstest run to run tests (run disables watch mode, suitable for CI)
• Use rstest --watch or rstest watch for local development with file watching
• Use rstest list to list all test files and test names
• Use rstest -u to update snapshots
• Use --reporter=verbose when debugging test failures for detailed output