vitest-unit-testing — правило для Claude Code: установка и суть
Правило vitest-unit-testing для Claude Code задаёт порядок написания юнит-тестов на Vitest. Помогает мокать модули и оформлять тесты компонентов.
AGPL-3.0 ★ 267 обновлён 2026-02-20
.cursor/rules/vitest-unit-testing.mdcЧто делает vitest-unit-testing
Правило задаёт стандарты написания тестов для ассистента. Оно регламентирует структуру Arrange-Act-Assert, группировку через блоки describe и строгую типизацию с expectTypeOf(). Для изолированных проверок предписывается использовать объект vi: предпочитать шпионы vi.spyOn() полным заглушкам, а фабрики vi.mock() выносить на верхний уровень файла.
Для тестирования компонентов в браузерном окружении правило требует указывать environment: 'jsdom' в vitest.config.ts и подключать утилиты тестировочных библиотек. Мок-фабрика выполняется раньше импортов, поэтому передавать в неё динамические переменные напрямую нельзя.
Какие задачи решает
- настроить моки функций через
vi.fn()иvi.spyOn() - структурировать тесты по схеме Arrange-Act-Assert
- подготовить конфигурацию
jsdomдля тестов компонентов - проверить типы выражений через
expectTypeOf()
Примеры запросов агенту
- Напиши юнит-тесты на Vitest для компонента кнопки с проверкой клика
- Настрой мок внешнего модуля через фабрику
vi.mock()на верхнем уровне - Добавь проверку типов в тесты с помощью
expectTypeOf()
Как установить vitest-unit-testing
Вручную: положить файлы
.cursor/rules/vitest-unit-testing.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.claude/rules/vitest-unit-testing.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/vitest-unit-testing.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/vitest-unit-testing.mdВручную: положить файлы
.clinerules/vitest-unit-testing.mdПо шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules
Вопросы о vitest-unit-testing
Как установить vitest-unit-testing в Claude Code?
Сохраните файл правила по пути .claude/rules/vitest-unit-testing.md в корне вашего проекта.
Что делает правило vitest-unit-testing?
Задаёт инструкции для Claude Code по оформлению тестов на Vitest, мокированию через vi и настройке jsdom.
Почему важно размещать vi.mock() на верхнем уровне файла?
Фабрика vi.mock() выполняется движком Vitest до обработки импортов. Если объявить её иначе, мок не перехватит вызовы зависимостей вовремя.