59 lines
4.3 KiB
Markdown
59 lines
4.3 KiB
Markdown
# Frontend testing
|
||
|
||
Перед нетривиальными тестами сформулируй
|
||
[общий Test Intent](engineering.md#test-intent); отдельный документ
|
||
не требуется. Trivial low-risk изменения обходятся без него.
|
||
|
||
## Выбор проверки
|
||
|
||
Читай при изменении тестов, доступа, денежных расчётов, восстановления
|
||
интерфейса или исправлении подтверждённой регрессии.
|
||
Выбирай boundary по наблюдаемому исходу, а не внутреннему helper/component state.
|
||
|
||
| Изменение | Дешёвая надёжная проверка |
|
||
| --- | --- |
|
||
| Чистое domain преобразование/денежный расчёт | Unit case с граничными значениями |
|
||
| Форма, route access, recovery, UI-state selection | RTL component/route test через видимое поведение |
|
||
| Headers, refresh/retry, query invalidation | MSW на transport boundary |
|
||
| Критический browser flow, который JSDOM не доказывает | Browser/e2e proof существующими доступными средствами; отдельный frontend e2e runner пока не принят |
|
||
| Только declarative props/Storybook fixture | Type/build + semantic/visual review; unit test без собственной логики не нужен |
|
||
|
||
Tests colocated с source (`*.test.tsx` для UI, существующий `*.test.ts` для pure code).
|
||
Arrange/Act/Assert, semantic queries (`getByRole`, label); test id — когда
|
||
пользовательский selector не выражает нужный элемент. Не тестируй Mantine/React
|
||
internals, private calls или passthrough wrapper ради coverage.
|
||
|
||
## Инструменты и isolation
|
||
|
||
Используй `fireEvent` из объявленного `@testing-library/react` и ожидай async
|
||
outcome через `findBy*`/`waitFor`. `user-event` доступен транзитивно через Storybook,
|
||
но не принят как direct dependency; не добавляй его ради старого Markdown.
|
||
MSW запускается только Vitest setup в `src/test/`, без browser worker/mock dev mode.
|
||
Проверяй сеть MSW handlers, а не mock внутренностей query client или реальный backend.
|
||
|
||
Независимый case получает свой `createTestQueryClient`; rerender сохраняет
|
||
экземпляр и seeded cache. Providers выбирай явно. Existing teardown выполняет
|
||
RTL cleanup, auth reset и MSW reset: [test client](../../src/test/query.tsx).
|
||
Тестовый клиент отключает retries запросов и мутаций для предсказуемого исхода;
|
||
это не меняет [политику обновления приложения](data.md#auth-и-invalidation).
|
||
|
||
## Важные случаи
|
||
|
||
Форма: field errors, отсутствие request при invalid input, submit blocking,
|
||
сохранение ввода при network error. Routes: доступ/redirect и neutral auth bootstrap.
|
||
Finance: loading/error/empty/loaded, cached snapshot при refetch failure, retry,
|
||
отсутствие старых данных после session/connection switch. ErrorBoundary: test-only
|
||
throwing route, безопасная ссылка и reset после navigation.
|
||
|
||
Примеры: [AuthForm test](../../src/features/auth/ui/AuthForm/AuthForm.test.tsx),
|
||
[client test](../../src/shared/api/client.test.ts),
|
||
[resource lifecycle test](../../src/shared/api/resource-query.test.tsx).
|
||
Не копируй fixtures/сценарии целиком, если задача затрагивает один исход.
|
||
|
||
## Команды
|
||
|
||
Итерация: `npm run test:run -- <path>` без coverage. Полный `npm run verify`
|
||
запускает Vitest один раз через `test:coverage`. Coverage floors — anti-regression
|
||
constraint, не повод тестировать декларации. После UI изменения отдельно
|
||
проверь доступность/визуальные состояния, которых JSDOM не доказывает.
|