# Vitest

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

CLion は [Vitest](https://vitest.dev/) と統合されており、 [Vite](https://vitejs.dev/)ネイティブのユニットテストフレームワークです。 実行、デバッグ、スナップショットテストの実行、およびエディターと実行 / デバッグ構成の両方からのテストカバレッジの測定を行うことができます。

失敗したテストを再実行するか、  ウォッチ モードをオンにできます。 このモードでテストセッションを開始すると、CLion はプロジェクトのソースコードの変更を監視します。 テストまたはテスト対象に変更があるとすぐに、CLion は該当するテストを再実行するため、実行/デバッグ構成を再起動する必要はありません。

## 始める前に

Procedure:

1. [Node.js](http://nodejs.org/#download) をダウンロードしてインストールします。

2. JavaScript と TypeScript  と  Vite  に必要なプラグインが   設定 | プラグイン   ページで有効化されていることを確認してください。 詳細については、 [プラグインの管理](managing-plugins.html)を参照してください。

## Vitest をインストールする

Procedure:

* コマンドライン シェルまたは組み込みの   ターミナルエミュレータ  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）で、次を入力します：

`npm install --save-dev vitest`

Vitest 公式 Web サイトで [オンラインドキュメント(英語)](https://vitest.dev/guide/)および [Vitest の設定(英語)](https://vitest.dev/guide/#configuring-vitest)の詳細を参照してください。

## テストの実行とデバッグ

CLion を使えば、エディターから直接単一の Vitest テストを素早く実行またはデバッグでき、実行/デバッグ構成を作成して一部またはすべてのテストを実行またはデバッグすることも可能です。

JavaScript および TypeScript コードの Vitest テストの作成の詳細については、Vitest 公式 Web サイトの [Vitest の機能(英語)](https://vitest.dev/guide/features.html)を参照してください。

Procedure: エディターから単一のテストを実行またはデバッグする

* ガターで ![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) または ![Rerun アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.rerun.svg) をクリックし、リストから   実行 <テスト名>；   を選択します。

![エディターから 1 つの Vitest テストを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vitest_run_test.png)

実行   ツールウィンドウでテストの実行結果を確認します。 失敗したテストについては、エラーが発生した場所と原因に関する情報が表示されます。

![エラーの詳細情報](https://resources.jetbrains.com/help/img/idea/2026.3/vitest_run_single_test_error_info.png)

ガターの  テストステータス アイコン ![テストが成功しました](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.testState.green2.svg) および ![テストが失敗しました](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.testState.red2.svg) により、エディターでテストが成功したか失敗したかを確認することもできます。

![テスト用のガターのアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/vitest_run_single_test_gutter_icons.png)

* テストをデバッグするには、テスト内に [ブレークポイントを設定し](using-breakpoints.html)、ガターで ![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) または ![Rerun アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.rerun.svg) をクリックし、リストから   <test_name> をデバッグ   を選択します。

![エディターから 1 つの Vitest テストをデバッグする](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vitest_debug_test.png)

デバッグ   ツールウィンドウで、 [中断されたテストを調](examining-suspended-program.html)べ、 [ステップ実行します](stepping-through-the-program.html)。

![Vitest デバッグセッション](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vitest_debug_tool_window.png)

Procedure: Vitest 実行構成を作成する

1. [実行 / デバッグ構成](run-debug-configurations-dialog.html)ダイアログ (メインメニューの  `実行 | 実行構成の編集​`  ) を開き、左側のペインで ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、リストから   Vitest   を選択します。 「   実行 / デバッグ構成: Vitest  」ダイアログが開きます。

> **Tip:**
> または、   プロジェクト   ツールウィンドウ（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) ）でテストファイルを選択し、コンテキストメニューから   <ファイル名> を作成；   を選択します。

2. 使用する Node.js ランタイムを指定します。

プロジェクト   エイリアスを選択すると、CLion は   ノードランタイム   フィールドの [JavaScript ランタイム](javascript-runtime.html)ページからプロジェクトデフォルトのインタープリターを自動的に使用します。 ほとんどの場合、CLion はプロジェクトのデフォルトランタイムを検出し、フィールドに自動的に入力します。

別の構成済みローカルインタープリターを選択するか、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックして新しいものを構成することもできます。

必要に応じて、Node.js に渡す [Node.js 固有のオプションパラメーター](run-debug-configuration-node-js.html#node_parameters)と [環境変数(英語)](https://www.w3schools.com/nodejs/nodejs_environment.asp)を指定します。

変数の定義は、   環境変数   フィールドにセミコロン (  `;` ) を区切りとして表示されます。例えば：

* `NODE_PATH` モジュール解決時に検索する追加ディレクトリのリストです。 リスト内のディレクトリを区切るには、macOS または Linux ではコロン ( `:` ) を、Windows ではセミコロン ( `;` ) を使用してください。

* `NODE_MODULE_CONTEXTS` 独自のグローバルコンテキストでモジュールをロードするには 1 に設定します。

* `NODE_DISABLE_COLORS` REPL の色を無効化するには 1 に設定します。

![環境変数](https://resources.jetbrains.com/help/img/idea/2026.3/nodeEnvironmentVariables.png)

または、フィールドの右側にある   閲覧   ![環境変数の編集](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.inline.variables.svg) をクリックし、表示される   環境変数   ダイアログで変数のリストを設定します：

* ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.paste.svg) ボタンを使用して、カスタム変数のリストを管理します。

* ダイアログには、使用可能なシステム環境変数のリストも表示されます。 現在の構成でシステム環境変数を使用しない場合は、 システム環境変数を含める チェックボックスをオフにしてください。

* 準備ができたら OK をクリックします。

3. `vitest`  パッケージの場所を指定します。

4. アプリケーションの作業ディレクトリを指定します。 デフォルトでは、   作業ディレクトリ   フィールドにはプロジェクトのルートフォルダーが表示されます。 この事前定義された設定を変更するには、目的のフォルダーへのパスを指定してください。

5. 実行するテストを指定します。 これは、特定のテストまたはスイート、テストファイル全体、テストファイルを含むフォルダーにすることができます。

6. デフォルトでは、  `vite.config.ts`  が使用されます。  `vite.config.ts`  が存在しない場合、またはカスタム構成を使用する場合は、使用する  `vitest.config.ts`  を指定します。 詳細については、 [Vitest オフィシャル Web サイト(英語)](https://vitest.dev/guide/#configuring-vitest)を参照してください。

7. オプション:

それらまたは関連するソースファイルの変更時に自動的に再実行されるテストを構成します。 これを行うには、   Vitest オプション   フィールドに  `--watch`  フラグを追加します。

他の Vitest オプションを追加することもできます。 詳細については、 [Vitest オフィシャル Web サイト(英語)](https://vitest.dev/guide/cli.html#options)を参照してください。

8. オプション:

ノード オプション   フィールドに、Node.js 実行可能ファイルに渡される Node.js 固有のコマンドラインオプションを入力します。 許容されるオプションは次のとおりです。

* 実行中に CoffeeScript ファイルをオンザフライで JavaScript にコンパイルするには、 `--require coffeescript/register` を使用します。 このモードでは、 `coffeescript` パッケージの一部である `register.js` ファイルがプロジェクト内に配置されている必要があります。 したがって、 [CoffeeScript コンパイラーをインストールする](coffeescript.html#ws_coffee_installation)の説明に従って、 `coffeescript` パッケージがローカルにインストールされていることを確認してください。

* [Chrome デバッグプロトコル(英語)](https://developer.chrome.com/devtools/docs/debugger-protocol)サポートには `--inspect` または `--inspect-brk` パラメーターを使用します。

Procedure: 実行構成を介してテストを実行する

1. 構成の一覧から Vitest 実行/デバッグ構成を選択し、一覧またはツールバーの ![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックします。

2. 実行   ツールウィンドウの   テストランナー   タブで、テストの実行を監視し、テスト結果を分析します。 詳細については、 [テスト結果の検証](viewing-and-exploring-test-results.html) を参照してください。

テストをデバッグするには、必要に応じて [ブレークポイントを設定し](using-breakpoints.html)、実行 / デバッグ構成を選択して、 ![the Debug button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) をクリックします。

![Vitest: テスト結果](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vitest_test_results.png)

## テストの再実行

指定したスコープ `Alt+Shift+R` (Windows), `⌘ ⌃ R` (macOS), `⌘ ⌃ R` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ R` (macOS System Shortcuts), `Alt+Shift+R` (XWin), `Alt+Shift+R` (GNOME), `Alt+Shift+R` (KDE), `Alt+Shift+R` (Emacs), `Alt+Shift+R` (Sublime Text), `⌘ ⌃ R` (Sublime Text (macOS)), `⌘ ⌃ R` (Xcode), `Alt+Shift+R` (Visual Studio), `Alt+Shift+R` (Visual Studio (macOS)), `Alt+Shift+R` (ReSharper), `Alt+Shift+R` (ReSharper (macOS)), `Alt+Shift+R` (QtCreator), `Alt+Shift+R` (QtCreator (macOS)), `Alt+Shift+R` (NetBeans), `Alt+Shift+G` (Eclipse), `⌘ ⌃ R` (Eclipse (macOS)) 内のすべてのテストを再実行するか、失敗したテストのみを再実行できます。

[--watch モード(英語)](https://vitest.dev/guide/features.html#watch-mode)でテストを起動することもできます。 このモードでは、CLion がテストおよび関連するテスト対象への保存された変更を監視します。 変更が検出されるとすぐに、CLion は現在のテストセッションを停止せずに影響したテストを再実行します。

> **Note:**
> CLion は、 `Ctrl+S` (Windows), `⌘ S` (macOS), `⌘ S` (IntelliJ IDEA Classic (macOS)), `⌘ S` (macOS System Shortcuts), `Ctrl+S` (XWin), `Ctrl+S` (GNOME), `Ctrl+S` (KDE), `Ctrl+X, Ctrl+S` (Emacs), `Ctrl+S` (Sublime Text), `⌘ S` (Sublime Text (macOS)), `⌘ S` (Xcode), `Ctrl+Shift+S` (Visual Studio), `⌘ ⇧ S` (Visual Studio (macOS)), `Ctrl+Shift+S` (ReSharper), `⌘ ⇧ S` (ReSharper (macOS)), `Ctrl+Shift+S` (QtCreator), `⌘ ⇧ S` (QtCreator (macOS)), `Ctrl+S` (NetBeans), `Ctrl+S` (Eclipse), `⌘ S` (Eclipse (macOS)) で手動保存した場合や、フォーカスの変更時など自動的に保存された更新のみ検出します。 詳細は [自動保存の設定](saving-and-reverting-changes.html#configure-autosave)をご覧ください。

Procedure: 失敗したテストを再実行

* テスト結果ツールバーの ![再実行失敗テストアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.restartFailedTests.svg) をクリックします。 CLion は前回のセッション中に失敗したすべてのテストを実行します。

![Vitest: 失敗したすべてのテストの再実行](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vitest_rerun_failed_test.png)

* 特定の失敗したテストを再実行するには、そのコンテキストメニューで  `<test name> を実行`  を選択します。

詳細については、 [テストの再実行](performing-tests.html#rerun)を参照してください。

Procedure: 更新されたテストを自動的に再実行する (--watch モード)

1. Vitest   実行 / デバッグ構成を開くか、 [上記のよう](#createRunConfigVitest)に新しい構成を作成します。

2. Vitest オプション   フィールドに  `--watch`  と入力します。 自動生成された   すべてのテスト   構成では、  `--watch`  オプションがすでに指定されています。

3. 実行 / デバッグ構成を起動します。 一部のテストが失敗した場合、テストセッションを停止することなく、それらのテストまたは関連するテストサブジェクトを更新できます。 変更が保存されるとすぐに、CLion はそれらを検出し、影響を受けるテストを再実行します。

以下の例では、  `vue.test.ts`  の  `29`  行でのテストが失敗します。  `--watch`  オプションを使うと、  `vue.test.ts`  で  `'4 x 4 = 18'` を  `'4 x 4 = 16'` に置き換えて変更を `Ctrl+S` (Windows), `⌘ S` (macOS), `⌘ S` (IntelliJ IDEA Classic (macOS)), `⌘ S` (macOS System Shortcuts), `Ctrl+S` (XWin), `Ctrl+S` (GNOME), `Ctrl+S` (KDE), `Ctrl+X, Ctrl+S` (Emacs), `Ctrl+S` (Sublime Text), `⌘ S` (Sublime Text (macOS)), `⌘ S` (Xcode), `Ctrl+Shift+S` (Visual Studio), `⌘ ⇧ S` (Visual Studio (macOS)), `Ctrl+Shift+S` (ReSharper), `⌘ ⇧ S` (ReSharper (macOS)), `Ctrl+Shift+S` (QtCreator), `⌘ ⇧ S` (QtCreator (macOS)), `Ctrl+S` (NetBeans), `Ctrl+S` (Eclipse), `⌘ S` (Eclipse (macOS))で保存するか、CLionからフォーカスを移動した後に、テストが再実行されます。

![Rerun updated test in the --watch mode](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vitest_watch_mode.animated.gif)

## スナップショットテスト

CLion は [Vitest スナップショットテスト](https://vitest.dev/guide/snapshot.html#snapshot)もサポートしています。 CLion が初めて  `toMatchSnapshot()`  メソッドでテストを実行すると、スナップショットファイルが作成され、  `toMatchSnapshot ()`  の横のガターに ![スナップショット](https://resources.jetbrains.com/help/img/idea/2026.3/javascript-impl.icons.jest.snapshotGutter.svg) アイコンが表示されます。 ![スナップショット アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/javascript-impl.icons.jest.snapshotGutter.svg) をクリックして、生成されたスナップショットを開きます。

![スナップショット](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vitest_snapshot.png)

## コードカバレッジを監視する

CLion を使用すると、 [Vitest テストでどれだけコードがカバーされているか](https://vitest.dev/guide/coverage.html#coverage)も監視できます。 CLion は、専用の   カバレッジ  ツールウィンドウにこの統計情報を表示し、カバーされた行とカバーされていない行をエディターおよび   プロジェクト  ツールウィンドウ（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）で視覚的にマークします。

![Vitest カバレッジレポート](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vitest_coverage_report.png)

Procedure: Vitest のコードカバレッジを有効にする

[@vitest/ カバレッジ v8(英語)](https://www.npmjs.com/package/@vitest/coverage-v8) または [istanbul(英語)](https://istanbul.js.org/) をインストールします。 これを行うには、組み込みの   ターミナルエミュレータ   `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS)) を開き、次のいずれかを入力します。

* `npm install --save-dev @vitest/coverage-v8`

* `npm install --save-dev @vitest/coverage-istanbul` 。

Vitest 公式 Web サイトで [カバレッジ(英語)](https://vitest.dev/guide/coverage.html#coverage)の詳細を参照してください。

Procedure: カバレッジでテストを実行する

* エディターからカバレッジ付きで特定のスイートまたはテストを実行します。ガターで ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) または ![再実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.rerun.svg) をクリックし、リストから   カバレッジで <test_name> を実行する   を選択します。

![エディターからのカバレッジで Vitest テストを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_vitest_run_with_coverage_editor.png)

あるいは:

[上記の説明に従って、Vitest 実行 / デバッグ構成](#createRunConfigVitest)を作成します。 メインツールバーのリストから Vitest 実行 / デバッグ構成を選択し、リストの右側にある ![カバレッジ付き実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.runWithCoverage.svg) をクリックします。

