Cucumber.js
Cucumber.js(英語) は、動作駆動型 JavaScript 開発用のテストフレームワークです。Cucumber.js テストは、人間が読める Gherkin(英語) 言語で記述されており、拡張子 feature を持つ機能(英語)ファイルに保存されます。RubyMine は Cucumber.js と統合し、Gherkin で記述された機能を認識するため、IDE から直接 Cucumber.js テストを実行できます。
始める前に
Cucumber.js バージョン 6.0.0+ を使用するには、RubyMine 2020.3.1 以降を使用していることを確認してください。
Node.js をダウンロードしてインストールします。
設定 | プラグインページのインストール済みタブで、JavaScript と TypeScript および Gherkin に必要なプラグインが有効になっていることを確認します。詳細については、「プラグインのマッピング」を参照してください。
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、設定 | プラグインページのマーケットプレースタブに Cucumber.js プラグインをインストールして有効にします。
Cucumber.js をインストールする
埋め込まれたターミナル(Alt+F12)で、次のいずれかのコマンドを入力します。
npm install cucumber
をプロジェクトにローカルインストールします。グローバルインストール用の
npm install -g cucumber
npm install --save-dev cucumber
は、Cucumber.js を開発依存関係(英語)としてインストールします。
Cucumber.js 公式サイトの Cucumber.js デモ(英語)も参照してください。
テスト定義の作成
RubyMine では、JavaScript と TypeScript の両方でステップ定義を書くことができます。RubyMine は定義が欠落しているステップを検出してハイライトし、生成するためのクイックフィックスを提案します。
定義なしのステップにキャレットを置き、Alt+Enter を押して、ステップ定義の作成またはすべてのステップ定義の作成を選択します。
または、ステップの上にマウスを移動し、ポップアップ内のリンクを使用します。
表示されたダイアログで、新しいファイルの名前と定義を書き込む言語を指定します。
そのようなファイルがすでに存在する場合は、RubyMine はポップアップを表示して、そこに定義を追加するファイルを選択するか、新しいファイルを作成することを選択する必要があります。
テストの実行
Cucumber.js テストは、実行 / デバッグ構成によってのみ起動されます。
Cucumber.js 実行構成を作成する
実行 / デバッグ構成ダイアログ (メインメニューの ) を開き、左側のペインで をクリックし、リストから Cucumber.js を選択します。実行 / デバッグ構成: Cucumber.js ダイアログが開きます。
機能ファイルまたはディレクトリフィールドで、実行するテストを指定します。多数の機能を実行する場合は、特定の .feature ファイルまたはフォルダーへのパスを入力します。
使用する Node.js インタープリターを指定します。
プロジェクトエイリアスを選択すると、RubyMine は Node.js ページの Node インタープリターフィールドからプロジェクトの既定のインタープリターを自動的に使用します。ほとんどの場合、RubyMine はプロジェクトの既定のインタープリターを検出し、フィールド自体に入力します。
別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、 をクリックして新しいインタープリターを構成することもできます。
Cucumber パッケージフィールドで、cucumber パッケージが格納されているフォルダーへのパスを指定します。
アプリケーションの作業ディレクトリを指定します。デフォルトでは、作業ディレクトリフィールドにはプロジェクトのルートフォルダーが表示されます。この定義済みの設定を変更するには、目的のフォルダーへのパスを指定します。
オプション:
「名前フィルター」フィールドに、フィーチャーファイルまたはディレクトリからのすべてのシナリオの代わりに実行する特定のシナリオの名前を入力します。
実行可能ファイルに渡すコマンドライン引数 (
-r
--require LIBRARY|DIR
、-t
--tags TAG_EXPRESSION
、--coffee
など) を指定します。詳細については、cucumber-js --help
コマンドを通じて利用できるネイティブの組み込みヘルプを参照してください。環境変数フィールドで、アプリケーションの環境変数を指定します。
実行構成を介してテストを実行する
構成のリストから Cucumber.js 実行 / デバッグ構成を選択し、リストまたはツールバーの をクリックします。
実行ツールウィンドウのテストランナータブで、テストの実行を監視し、テスト結果を分析します。詳細については、テスト結果を調べるを参照してください。
テストファイルからテストを実行する
単一のテストを実行するには、エディターでテストファイルを開き、実行するシナリオにキャレットを置き、コンテキストメニューから
を選択します。単一のテストファイルからすべてのテストを実行するには、エディターでテストファイルを開くか、プロジェクトツールウィンドウでテストファイルを選択し、コンテキストメニューから を選択します。
どちらの場合でも、RubyMine は実行 / デバッグ構成を作成し、後で保存して使用することができます。
デバッグテスト
必要に応じてブレークポイントの設定。
実行構成によるテストのデバッグ
構成のリストから Cucumber.js 実行 / デバッグ構成を選択し、リストまたはツールバーの をクリックします。
実行ツールウィンドウのテストランナータブで、テストの実行を監視し、テスト結果を分析します。詳細については、テスト結果を調べるを参照してください。
テストファイルからテストをデバッグする
単一のテストをデバッグするには、必要に応じてブレークポイントを設定し、デバッグするシナリオにキャレットを置き、コンテキストメニューから を選択します。
単一のテストファイルからすべてのテストをデバッグするには、エディターでテストファイルを開くか、プロジェクトツールウィンドウでテストファイルを選択し、コンテキストメニューから を選択します。
どちらの場合でも、RubyMine は実行 / デバッグ構成を作成し、後で保存して使用することができます。
TypeScript で書かれたテストの実行とデバッグ
上記のように Cucumber.js 実行 / デバッグ構成を作成します。
起動前領域で をクリックし、リストから TypeScript のコンパイルを選択して、使用する tsconfig.json ファイルを指定します。RubyMine は、Cucumber.js を実行する前に、この tsconfig.json を使用して TypeScript コンパイラーを実行します。
TypeScript で書かれたテストをデバッグするには、tsconfig.json を開き、
"sourceMap": true
を設定してソースマップを有効にします。
ナビゲーション
RubyMine を使用すると、ファイルと関連テストファイルの間、またはテストランナータブのテスト結果からテストに移動できます。
テストとそのサブジェクト間、またはその逆に移動するには、エディターでファイルを開き、コンテキストメニューから
または を選択するか、Ctrl+Shift+T を押します。.feature ファイルのステップからステップ定義に移動するには、Ctrl を押したまま、ステップにカーソルを合わせ、リンクになったときにステップをクリックします。
テスト結果からテスト定義に移動するには、「テストランナー」タブでテスト名を 2 回クリックするか、コンテキストメニューから「 」を選択するか、単に F4 を押します。テストファイルがエディターで開き、テスト定義にキャレットが置かれます。
構文ハイライトを構成する
好みや習慣に応じて、Cucumber.js 対応の構文ハイライトを設定できます。
設定ダイアログ(Ctrl+Alt+S)で、 に移動します。
配色を選択するか、デフォルトから継承されたハイライト設定を受け入れるか、色とフォントを設定する説明に従ってカスタマイズします。
関連ページ:
プラグインのインストール
プラグインは RubyMine のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して IDE 設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains...
Node.js
開始する前に、JetBrains マーケットプレイスからプラグインをインストールするに従って、Node.js プラグインが設定 | プラグインページのタブマーケットプレースにインストールされていることを確認してください。次の Node.js バージョンは、RubyMine 2023.3 以降でサポートされています。Node.js 20 - アクティブな長期サポート (LTS) バージョン、Node.js 21 - 現在のバージョン、サポートされている Node.js バージョンの詳細情報 Node...
テスト結果の表示と調査
テストを実行すると、実行ツールウィンドウに進行状況とテストセッションの結果が表示されます。ここでは、テストの統計を表示したり、スタックトレースに移動したり、成功したテストを表示または非表示にしたりできます。アプリケーションの実行と同じ方法で、テストの実行を再実行および終了できます。一般的な実行アクションに加えて、次のことができます。テスト結果のフィルタリングと並べ替え、テスト結果間を移動する、以前のテストの結果を表示する、テスト結果のエクスポート、テスト結果のフィルタリングと並べ替え:をクリッ
ブレークポイント
ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、単純な場合(たとえば、コード行に到達したときにプログラムを一時停止する場合)や、より複雑なロジック(追加の条件に対するチェック、ログメッセージの書き込みなど)を伴う場合があります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類:RubyMine
色とフォントを設定する
開発者は、エディターのソースコード、検索結果、デバッガー情報、コンソールの入出力など、多くのテキストリソースを操作します。このテキストのフォーマットには色とフォントスタイルが使用されており、一目で理解できるようになります。RubyMine では、IDE テキストで使用される色とフォントを定義する構成可能な配色から選択できます。事前定義された配色を使用するか、あなたの好みに合わせてカスタマイズすることができます。スキームを共有することも可能です。配色を選択を押して IDE 設定を開き、を選択する...
JavaScript のテスト
RubyMine を使用すると、Karma、Vitest、Jest、Protractor、Cucumber.js、Mocha、Node.js テストランナーを使用して JavaScript ユニットテストを実行およびデバッグできます。テスト結果はツリービューで確認でき、そこからテストソースに簡単に移動できます。テストのステータスは、エディターのテストの隣に表示され、すぐに実行またはデバッグするオプションがあります。Jest、Karma、Mocha については、RubyMine のコードカバレッジ...