ReSharper 2024.3 ヘルプ

JavaScript によるユニットテストの支援

ReSharper は、Visual Studio でクニット(英語)および Jasmine(英語) フレームワークの単体テストを検出して実行できます。

ReSharper を使用すると、単一の単体テスト、ファイル、プロジェクト、ソリューション内のすべてのテストを実行できます。テストセッションで組み合わせて、任意の数のテストを実行することもできます。

JavaScript ユニットのテスト設定の構成

Jasmine フレームワークを使用する場合は、ReSharper オプション Alt+R, Oツール | ユニットテスト | テストフレームワーク | JavaScript テストページでフレームワークバージョンを選択してください。

デフォルトでは、テストが開始されると、ReSharper はデフォルトの Web ブラウザーを起動し、ユニットテストフレームワークからの出力を表示します。テストを実行し、情報を ReSharper に報告します。必要に応じて、ReSharper オプションのツール | ユニットテスト | テストフレームワーク | JavaScript テストページでブラウザーを変更することができます。ブラウザーを起動せずに PhantomJS ライブラリでテストを実行することもできます。これを行うには、PhantomJS を選択し、PhantomJS 実行ファイルへのパスを指定し、必要に応じてデフォルトのコマンドライン引数を変更します。

テスト用にカスタム HTML ハーネスを指定できます。ハーネスは Chutzpah テストランナー(英語)と互換性があり、特別な Chutzpah プレースホルダー(英語)を使用できます。

カスタム HTML ハーネスを使用する

  1. ReSharper オプション Alt+R, Oツール | ユニットテスト | テストフレームワーク | JavaScript テストページでカスタム HTML ハーネスを有効にするチェックボックスをオンにします。

  2. ハーネスファイルがない場合は、空の HTML ファイルを作成し、デフォルト実装をクリップボードにコピーするをクリックしてデフォルトのハーネステンプレートをファイルに貼り付けることができます。

  3. ハーネスファイルのファイル名またはパスを入力します。

  4. テストハーネスの場所セレクタを使用して、ファイル名またはパスをテストランナーがどのように扱うべきかを指定します。

  5. オプションダイアログで保存をクリックして変更を適用し、ReSharper に変更を保存する場所を選択させるか、保存先セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「resharper 設定の管理と共有」を参照してください。

現在のドキュメントでのテストの発見

ReSharper はサポートされているすべてのフレームワークのユニットテストスイートとシングルユニットテストをエディター内で発見し、エディター内の各項目の横に対応するアクションインジケータを追加します。

次の例は、Jasmine フレームワークを使用して作成された単体テストスイートを示しています。

ReSharper shows different indicators for unit tests in the editor

ThemedIcon.UnitTestingOptionsPage.Screen.(Gray).png

この関数は、実行できる単体テストです。

ThemedIcon.UnitSession.Screen.(Gray).png

この関数は単体テストスイートであり、テストを含むものを実行できます

Passed

ユニットテストは、最後の実行中に合格しました。

Passed

ユニットテストスイートのテストは、最後の実行中に合格しました。

Failed

ユニットテストは最後の実行中に失敗しました。

Failed

単体テストスイートの少なくとも 1 つのテストが、最後の実行中に失敗しました。

現在のドキュメントでテストを実行またはデバッグする

現在のドキュメントでユニットテストを実行またはデバッグする方法はいくつかあります。アクションインジケータ、メインメニュー、ショートカットを使用することができます:

  • テストクラス内の単一のテストまたはすべてのテストを実行またはデバッグするには、その隣のアクションインジケーターをクリックするか、キャレットをテスト / テストスイートに置いて Alt+Enter を押します。アクションリストで、テストの場合は実行を、テストスイートの場合はすべて実行を選択します。

  • または、ユニットテストの実行 Run Unit Tests Control+T R コマンドを使用することもできます。このコマンドは、メインメニュー(ReSharper | ユニットテスト)およびコンテキストメニューでも使用できます。これらのコマンドは、キャレットの位置またはエディターでの選択に応じて動作が異なります。

    • テストスイート内の単一のテストまたはすべてのテストを実行またはデバッグするには、エディターのテスト / テストスイート名、またはその宣言内の任意の場所にキャレットを置きます。

    • 複数のテストを実行するには、エディターで目的のテストを選択します。

    • 現在のファイル内のすべてのテストを実行するには、すべてを選択するか、テストスイートの外側にキャレットを置きます。

テストの実行またはデバッグをどのように選択しても、実行の進行状況、結果、出力が Unit Test Sessions ウィンドウに表示されます。開いている単体テストセッションがある場合、実行されたテストはそのセッションに追加されます。テストセッションがないか、既存のセッションがロックされている場合、新しいテストセッションが作成されます。

必要に応じて、Control+T T を押すか、メニューから ReSharper | ユニットテスト | 前回の実行を繰り返しを選択することで、最後に実行したテストをいつでも再実行できます。

Running a Jasmine unit test suite from the editor

ソリューションの単体テストを発見する

ReSharper は、ユニットテストエクスプローラーウィンドウを Visual Studio(ReSharper | ユニットテスト | ユニットテストまたは ReSharper | Windows | ユニットテスト、または Control+Alt+T)に追加します。このウィンドウを使用すると、ソリューション全体でサポートされているすべてのフレームワークの単体テストを調べて実行できます。プロジェクトの単体テストは、プロジェクトがビルドされた後にのみウィンドウに表示されることに注意してください。現在開いているファイルのテストは自動的に更新され、開いているファイルの新しいテストは、作成するとすぐに単体テストエクスプローラーに表示されます。

単体テストエクスプローラーでは、次のことができます。

  • ソリューション内のテストを探索します。すべての単体テストをツリービューで参照し、テストを検索して部分文字列でフィルタリングし、単体テストをプロジェクト、名前空間などで再グループ化します。

  • ビュー内でダブルクリックして、テストまたはテストスイートのソースコードに移動します。

  • 選択したテストを実行します。

  • 選択したテストおよびテストスイートから単体テストセッションを作成するを選択したり、選択した項目を現在のテストセッションに追加したりできます。

Unit Test Explorer displays test from the entire solution

プロジェクトまたはソリューションで単体テストを実行またはデバッグする

単体テストエクスプローラー、ソリューションエクスプローラー、またはクラスビューからテストを実行またはデバッグできます。単体テストエクスプローラーには、テストとテストスイートのみを表示できるという利点がありますが、他のウィンドウを使用する場合は、どのプロジェクト、ファイル、クラスにテストが含まれているかを知る必要があります。

  • 単体テストエクスプローラーからテストを実行するには、目的のテストを選択し、ツールバーのユニットテストの実行 Run Unit Tests Control+T R をクリックします。

    複数のテストを選択するには、グループ化ノードを選択するか、Ctrl キーを押しながら目的の項目をクリックします。あるいは、検索フィールドにクエリ文字列を入力して、実行前に一致しないテストをすべて除外します。この場合、残りの一致するテストのみが実行されます。

  • ソリューションエクスプローラーまたは Class View からテストを実行またはデバッグするには、テストを含む 1 つ以上のアイテム (スイート、ファイル、フォルダー、プロジェクト) を選択し、メインメニュー (ReSharper | ユニットテスト ) およびコンテキストメニューでも利用できるユニットテストの実行 Run Unit Tests Control+T R コマンドを使用します。

  • ソリューション内のすべてのテストを実行またはデバッグするには、メインメニューで ReSharper | ユニットテスト | ソリューションからすべてのテストを実行を選択するか、Control+T L を押します。

テストの実行またはデバッグをどのように選択しても、実行の進行状況、結果、出力が Unit Test Sessions ウィンドウに表示されます。開いている単体テストセッションがある場合、実行されたテストはそのセッションに追加されます。テストセッションがないか、既存のセッションがロックされている場合、新しいテストセッションが作成されます。

必要に応じて、Control+T T を押すか、メニューから ReSharper | ユニットテスト | 前回の実行を繰り返しを選択することで、最後に実行したテストをいつでも再実行できます。

単体テストセッションの使用

アプリケーションの特定の部分を対象とする単体テストを複数の単体テストセッションにグループ化できます。単体テストセッションには、さまざまなプロジェクトからのテストを含めることができます。複数のテストセッションを用意し、必要に応じて個別に実行できます。単一のテスト / テストスイートを複数の異なるテストセッションに含めることができます。

単体テストセッションの詳細については、「ユニットテストセッション」を参照してください。

実行プロセス

ReSharper には、単体テストを実行する方法がいくつか用意されています。どちらの方法を選択しても、実行の進行状況、テスト結果、出力が単体テストセッションウィンドウに表示されます。

テストは単体テストセッションで実行されているため、実行の進行状況は単体テストセッションウィンドウのツールバーのステータスバーに表示され、進行状況アイコンが現在実行中のテストの横に表示されます。複数の単体テストセッションを同時に実行できます。

必要に応じて、ツールバーの実行中のテストを追跡 ThemedIcon.TrackRun.Screen.(Gray).png オプションを有効にすることができます。オンの場合、テストツリー内の選択は、現在実行中のテストに自動的に切り替えられ、出力パネルは実行中に現在のテストの出力を常に表示します。

テスト実行時の自動スクロール出力 ThemedIcon.ScrollToBottom.Screen.(Gray).png オプションを有効にして、実行中のテストの出力に従うこともできます。

ReSharper: Unit test sessions in JavaScript

実行結果と出力を分析する

テストの実行が終了すると、結果がユニットテストセッションウィンドウに表示されます。

出力ペイン(ツールバーの出力を表示する Show Output ボタンを使用して右側または下部に配置できます)には、選択したテストの出力が表示されます。テストが失敗した場合、ReSharper は失敗に関する短い情報を追加したり、例外のスタックトレースを表示したりします。出力ペインのクリック可能なリンクを使用して、障害に関連するタイプとメソッドに直接移動できます。ソリューションに属していないファイルへのリンクが出力に表示される場合は、このリンクをクリックして、対応するファイルタイプに関連付けられた外部アプリケーションでファイルを開くか、Ctrl -click でファイルを Visual Studio で開くことができます。

デフォルトでは、ReSharper は、出力領域の現在の幅に従って、長い行を出力に折り返します。必要に応じて、ReSharper オプションのツール | ユニットテストページのユニットテストセッションの出力で長い行を折り返すチェックボックスをオフにして、長い行を折り返さないように選択します。

ツールバーのグループ化セレクターを使用して、テストのグループ化を変更します。セレクターの上部にある定義済みのグループ化モードの 1 つ(テスト階層、プロジェクト構造など)を選択するか、下部を使用できます。グループ化プロパティのカスタムセットを選択するためのセレクター。

ステータスバーには、セッション内のテストの合計数と、さまざまな状態のテスト数が表示されます。

Unit test filters

デフォルトでは、すべての状態のテストが表示されますが、対応するアイコンをクリックすると、その状態でテストをフィルターできます。Ctrl - 複数のアイコンをクリックして、いくつかの異なる状態でテストを表示することもできます。

Unit Test Sessions ウィンドウの各テストのステータスは、次のアイコンのいずれかで表示されます。

ThemedIcon.RunningTest.Screen.(Gray).png

単体テストは現在実行中です

ThemedIcon.TestPending.Screen.(Gray).png

単体テストは現在の実行で実行されるようにスケジュールされています

ThemedIcon.StatusUnknown.Screen.(Gray).png

単体テストは実行されませんでした

ThemedIcon.Success.Screen.(Gray).png

lats テストの実行でユニットテストに合格しました

ThemedIcon.Error.Screen.(Gray).png

lats テストの実行でユニットテストが失敗しました

ThemedIcon.StatusAborted.Screen.(Gray).png

ユニットテストは最後のテスト実行で中止されました

ThemedIcon.StatusInconclusive.Screen.(Gray).png

単体テストが開始されましたが、ReSharper はテストランナーの出力を読み取ることができませんでした。これは通常、テストの実行を中止したときに発生しますが、テストランナーでエラーが発生した可能性もあります。

グループ化項目のステータスを表示するために同じアイコンが使用されます (スイート、プロジェクトなど)

アイコンは各セッションのタブでも使用され、セッションの全体的な実行結果を表示します。

テストセッションツリーの上にある対応するアイコンは、各状態にあるテストの数を示しています。ThemedIcon.UnitSession.Screen.(Gray).png アイコンは、セッション内のテストの総数を示します。

これらのアイコンを使用して、対応するステータスのテストのみが表示されるようにツリーをフィルタリングできます。

関連ページ:

ReSharper 設定の管理と共有

ReSharper は、階層化された設定のメカニズムを使用して環境設定を保存するため、次の利点があります。さまざまなソリューションで異なる設定を行うことができます。環境設定のさまざまなサブセットを別の場所に保存し、特定のソリューションで作業するときに環境設定を組み合わせることができます。例: 記号のアイコンとチーム設定のコード形式を個人設定で保存し、これらの設定を自動的に組み合わせることができます。設定の特定のサブセットを VCS に保持することにより、チーム内の設定を同期できます。ReShar...

アクションインジケーターとアクションリスト

ReSharper が Visual Studio テキストエディターに追加する最も注目すべきものの中には、アクションインジケータとアクションリストがあります。これらは、ReSharper でサポートされているすべてのファイル(C#、VB.NET、XML、CSS、JavaScript、ASP.NET など)に表示され、使用可能なアクションについて通知し、適用できます。アクションインジケータ:アクションインジケーターは、設定に応じて、アクションバー、テキストエディターの左マージンおよび / また...

Unit Test Sessions ウィンドウ

ReSharper は、単体テストセッションウィンドウで単体テストを実行します。このウィンドウは、現在のドキュメントまたはプロジェクトまたはソリューションからテストを実行すると、自動的に表示されます。詳細については、「ユニットテストセッション」を参照してください。このウィンドウは、複数の単体テストセッションを同時に、独立して実行できるように設計されています。セッションは、任意の組み合わせのテストで構成できます。デバッグモードでは、一度に実行できるセッションは 1 つだけです。ユニットテストツリー...

ユニットテストエクスプローラーウィンドウ

このウィンドウを使用すると、ソリューション全体でサポートされているすべてのフレームワークの単体テストを調べて実行またはデバッグできます。プロジェクトの単体テストは、プロジェクトのビルド後にのみウィンドウに表示されることに注意してください。現在開いているファイルからのテストは自動的に更新され、開いているファイルからの新しいテストは、作成するとすぐに単体テストエクスプローラーに表示されます。詳細については、「プロジェクトまたはソリューションでの単体テストの操作」を参照してください。テストを検索するに...

単体テスト支援

ReSharper は、Visual Studio で単体テストの検出と実行、デバッグを行うのに役立ちます。以下のユニットテストフレームワークがサポートされています:NUnit — ReSharper インストールには、それぞれ 2.7.1 までのバージョンと 3.15.5 までのバージョンをサポートする 2 つのバンドルされたテストランナーが含まれています。4.1.0 までの他のバージョンもサポートされており、対応する NuGet パッケージがプロジェクトにインストールされている場合に使用されま...

プロジェクトまたはソリューションで単体テストを操作する

ソリューションの単体テストを発見する:ReSharper は、ユニットテストエクスプローラーウィンドウを Visual Studio(または、または)に追加します。このウィンドウを使用して、ソリューション全体でサポートされているすべてのフレームワークの単体テストを調査、実行、デバッグできます。プロジェクトの単体テストは、プロジェクトがビルドされた後にのみウィンドウに表示されることに注意してください。現在開いているファイルのテストは自動的に更新され、開いているファイルの新しいテストは、作成する...