vitest - SKILL.md Agent Skill

name: vitest description: Vite ベースの高速ユニットテストフレームワーク。Jest 互換 API を提供。テストの作成、モック、カバレッジ設定、テストのフィルタリングやフィクスチャを扱う時に使用。 metadata: author: Anthony Fu version: "4.0.18" source: Updated from https://vitest.dev/blog/vitest-4 and https://vitest.dev/guide/migration.html

Vitest は Vite を基盤とした次世代テストフレームワーク。Jest 互換の API を提供し、ESM・TypeScript・JSX をネイティブにサポートする（設定不要）。Vitest は Vite アプリと同じ設定、トランスフォーマー、リゾルバー、プラグインを共有する。

主な特徴:

このスキルは Vitest 4.x（4.0.18）対応。 3.x からのマイグレーションが必要な場合は公式ガイドを参照: https://vitest.dev/guide/migration.html

変更内容	3.x	4.x
ワークスペース設定	`workspace` / `vitest.workspace.js`	`projects`（`vitest.config.ts` 内に統合）
ワーカー数設定	`maxThreads` / `maxForks`	`maxWorkers`
シングルスレッド	`singleThread` / `singleFork`	`maxWorkers: 1, isolate: false`
プールオプション	`poolOptions.threads.*`	トップレベルに昇格
カバレッジ	`coverage.all`, `coverage.extensions`	削除（`coverage.include` を明示指定）
モジュール実行	vite-node	Vite ModuleRunner
モック名デフォルト	`"spy"`	`""（空文字列）`
`restoreAllMocks`	すべてのモック対象	`vi.spyOn` で作成したスパイのみ
`invocationCallOrder`	0 始まり	1 始まり（Jest 互換）
テストオプション	第3引数でオプション指定可	第2引数のみ
basic レポーター	利用可能	削除（`default` + `summary: false` で代替）
verbose レポーター	ツリー表示	フラット表示（ツリーは `--reporter=tree`）
ブラウザモード	`@vitest/browser/context`	`vitest/browser`
環境変数	`VITE_NODE_DEPS_MODULE_DIRECTORIES`	`VITEST_MODULE_DIRECTORIES`
環境変数	`VITEST_MAX_THREADS` / `VITEST_MAX_FORKS`	`VITEST_MAX_WORKERS`

トピック	説明	リファレンス
設定	Vitest と Vite の設定統合、defineConfig、projects 設定	core-config
CLI	コマンドラインインターフェース、コマンドとオプション	core-cli
Test API	test/it 関数、skip・only・concurrent 等の修飾子	core-test-api
Describe API	テストのグルーピングとネストされたスイート用の describe/suite	core-describe
Expect API	アサーション、スキーママッチング、ビジュアルリグレッション	core-expect
フック	beforeEach、afterEach、beforeAll、afterAll、aroundEach	core-hooks

トピック	説明	リファレンス
モック	vi ユーティリティによる関数・モジュール・タイマー・日付のモック	features-mocking
スナップショット	toMatchSnapshot とインラインスナップショットによるスナップショットテスト	features-snapshots
カバレッジ	V8（AST ベース解析）または Istanbul によるコードカバレッジ	features-coverage
テストコンテキスト	テストフィクスチャ、context.expect、カスタムフィクスチャ用の test.extend	features-context
並行実行	並行テスト、並列実行、シャーディング	features-concurrency
フィルタリング	名前、ファイルパターン、タグによるテストのフィルタリング	features-filtering

トピック	説明	リファレンス
Vi ユーティリティ	vi ヘルパー: mock、spyOn、フェイクタイマー、hoisted、waitFor	advanced-vi
環境	テスト環境: node、jsdom、happy-dom、カスタム	advanced-environments
型テスト	expectTypeOf と assertType による型レベルテスト	advanced-type-testing
プロジェクト	マルチプロジェクト設定（workspace から projects に移行）	advanced-projects