# vitest-unit-testing

Правило vitest-unit-testing для Claude Code задаёт порядок написания юнит-тестов на Vitest. Помогает мокать модули и оформлять тесты компонентов.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 267 у репозитория
- Автор: przeprogramowani
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/przeprogramowani/ai-rules-builder/tree/HEAD/.cursor/rules/vitest-unit-testing.mdc
- Обновлён: 2026-02-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/vitest-unit-testing

## Что делает

Правило задаёт стандарты написания тестов для ассистента. Оно регламентирует структуру Arrange-Act-Assert, группировку через блоки `describe` и строгую типизацию с `expectTypeOf()`. Для изолированных проверок предписывается использовать объект `vi`: предпочитать шпионы `vi.spyOn()` полным заглушкам, а фабрики `vi.mock()` выносить на верхний уровень файла.

Для тестирования компонентов в браузерном окружении правило требует указывать `environment: 'jsdom'` в `vitest.config.ts` и подключать утилиты тестировочных библиотек. Мок-фабрика выполняется раньше импортов, поэтому передавать в неё динамические переменные напрямую нельзя.

## Установка

### Cursor (родная платформа)

**Вручную: положить файлы**
- Файл: `.cursor/rules/vitest-unit-testing.mdc` — Во frontmatter: description, globs, alwaysApply

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/vitest-unit-testing.md` — Поле paths во frontmatter ограничивает файлы: globs из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/vitest-unit-testing.instructions.md` — Поле applyTo задаёт, к каким файлам применять: globs из источника → applyTo

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/vitest-unit-testing.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/vitest-unit-testing.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/przeprogramowani/ai-rules-builder/tree/HEAD/.cursor/rules/vitest-unit-testing.mdc

## Когда брать
- настроить моки функций через `vi.fn()` и `vi.spyOn()`
- структурировать тесты по схеме Arrange-Act-Assert
- подготовить конфигурацию `jsdom` для тестов компонентов
- проверить типы выражений через `expectTypeOf()`

## Примеры запросов агенту
- Напиши юнит-тесты на Vitest для компонента кнопки с проверкой клика
- Настрой мок внешнего модуля через фабрику `vi.mock()` на верхнем уровне
- Добавь проверку типов в тесты с помощью `expectTypeOf()`

## Похожие
- [vitest-unit-testing-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/vitest-unit-testing-cursorrules-prompt-file.md) — правило · ★ 41178 у репозитория
- [vitest-testing](https://affpapa.org/nevibecode/skills/oakoss-vitest-testing.md) — скилл · 226 установок
- [vitest-testing-patterns](https://affpapa.org/nevibecode/skills/vitest-testing-patterns.md) — скилл · 373 установки
- [unit-test-generator](https://affpapa.org/nevibecode/skills/unit-test-generator.md) — скилл · 379 установок
- [vitest](https://affpapa.org/nevibecode/skills/claude-mpm-team-vitest.md) — скилл · 949 установок
- [vitest-skill](https://affpapa.org/nevibecode/skills/vitest-skill.md) — скилл · 506 установок

Из того же набора: [przeprogramowani/ai-rules-builder](https://affpapa.org/nevibecode/by/przeprogramowani/ai-rules-builder.md) — 24 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
