Cucumber.js

1. Cucumber.js バージョン 6.0.0+ を使用するには、WebStorm 2020.3.1 以降を使用していることを確認してください。

2. お使いのコンピューターに Node.js(英語) がインストールされていることを確認してください。

3. 設定 | プラグインページのインストール済みタブで、Cucumber.js および Gherkin に必要なプラグインが有効になっていることを確認します。詳細については、「プラグインのマッピング」を参照してください。

• 埋め込まれたターミナル（Alt+F12）で、次のいずれかのコマンドを入力します。

  • npm install cucumber をプロジェクトにローカルインストールします。

  • グローバルインストール用の npm install -g cucumber

  • npm install --save-dev cucumber は、Cucumber.js を開発依存関係(英語)としてインストールします。

  Cucumber.js 公式サイトの Cucumber.js デモ(英語)も参照してください。

1. 定義なしのステップにキャレットを置き、Alt+Enter を押して、ステップ定義を作成するまたはすべてのステップ定義を作成するを選択します。

   

   または、ステップの上にマウスを移動し、ポップアップ内のリンクを使用します。

   

2. 表示されたダイアログで、新しいファイルの名前と定義を書き込む言語を指定します。

   

   そのようなファイルがすでに存在する場合は、WebStorm はポップアップを表示して、そこに定義を追加するファイルを選択するか、新しいファイルを作成することを選択する必要があります。

Cucumber.js 実行構成を作成する

1. 実行 / デバッグ構成ダイアログ (メインメニューの実行 | 実行構成の編集 ) を開き、左側のペインで をクリックし、リストから Cucumber.js を選択します。「実行 / デバッグ構成: Cucumber.js」ダイアログが開きます。

2. フィーチャーファイルまたはディレクトリフィールドで、実行するテストを指定します。多数の機能を実行する場合は、特定の .feature ファイルまたはフォルダーへのパスを入力します。

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

   プロジェクトエイリアスを選択した場合、WebStorm は JavaScript ランタイムページのノードランタイムフィールドにあるプロジェクトのデフォルトインタープリターを自動的に使用します。ほとんどの場合、WebStorm はプロジェクトのデフォルトランタイムを検出し、そのフィールドに自動的に入力します。

   別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、 をクリックして新しいインタープリターを構成することもできます。

   詳細については、「リモート Node.js ランタイムの構成」、「ローカル Node.js ランタイムの構成」、「Linux の Windows サブシステムで Node.js を使用する」を参照してください。

4. Cucumber パッケージフィールドで、cucumber パッケージが格納されているフォルダーへのパスを指定します。

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

6. オプション:

   • 「名前フィルター」フィールドに、フィーチャーファイルまたはディレクトリからのすべてのシナリオの代わりに実行する特定のシナリオの名前を入力します。

   • 実行可能ファイルに渡すコマンドライン引数 ( -r --require LIBRARY|DIR、-t --tags TAG_EXPRESSION、--coffee など) を指定します。詳細については、cucumber-js --help コマンドを通じて利用できるネイティブの組み込みヘルプを参照してください。

   • 環境変数フィールドで、アプリケーションの環境変数を指定します。

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

1. 構成のリストから Cucumber.js 実行 / デバッグ構成を選択し、リストまたはツールバーの をクリックします。

   

2. 実行ツールウィンドウのテストランナータブで、テストの実行を監視し、テスト結果を分析します。詳細については、テスト結果を調べるを参照してください。

テストファイルからテストを実行する

• 単一のテストを実行するには、エディターでテストファイルを開き、実行するシナリオにキャレットを置き、コンテキストメニューからシナリオ実行: ＜シナリオ名＞を選択します。

• 単一のテストファイルからすべてのテストを実行するには、エディターでテストファイルを開くか、プロジェクトツールウィンドウでテストファイルを選択し、コンテキストメニューから <テストファイル名> を実行しますを選択します。

どちらの場合でも、WebStorm は実行 / デバッグ構成を作成し、後で保存して使用することができます。

• テストとそのサブジェクト間、またはその逆に移動するには、エディターでファイルを開き、コンテキストメニューから移動先 | テストまたは移動先 | テスト対象を選択するか、Ctrl+Shift+T を押します。

• .feature ファイルのステップからステップ定義に移動するには、Ctrl を押したまま、ステップにカーソルを合わせ、リンクになったときにステップをクリックします。

• テスト結果からテスト定義に移動するには、「テストランナー」タブでテスト名を 2 回クリックするか、コンテキストメニューから「ソースに移動」を選択するか、単に F4 を押します。テストファイルがエディターで開き、テスト定義にキャレットが置かれます。

1. 設定ダイアログ（Ctrl+Alt+S）で、エディター | カラースキームの切り替え | Cucumber に移動します。

2. 配色を選択するか、デフォルトから継承されたハイライト設定を受け入れるか、色とフォントの説明に従ってカスタマイズします。