WebStorm 2025.1 ヘルプ

Protractor

Protractor (英語) は、Angular(英語) および AngularJS(英語) アプリケーション用のテストフレームワークです。Protractor は、実際のブラウザーで実行されているアプリケーションに対してテストを実行し、テスト結果の正確さと信頼性を保証します。WebStorm は Protractor と統合されているため、IDE 内からテストを実行およびデバッグできます。テスト結果はツリービューで確認でき、そこからテストソースに簡単に移動できます。

始める前に

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

  2. 設定で Angular と AngularJS プラグインが有効になっていることを確認します。Ctrl+Alt+S を押して設定を開き、プラグインを選択します。インストール済みタブをクリックします。検索フィールドに Angular と AngularJS と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。

Protractor をインストールする

Protractor は、ローカルに、プロジェクトに、またはグローバルにインストールできます。グローバルインストールが望ましい

Protractor をグローバルにインストールする

  1. 埋め込まれたターミナルAlt+F12)で、次のように入力します。

    npm install -g protractor

  2. 必要なバイナリをダウンロードするには、webdriver-manager update と入力します。Protractor の公式サイトでスタートする(英語)も参照してください。

テストの実行

Protractor テストは、実行 / デバッグ構成によってのみ起動されます。

Protractor 実行構成を作成する

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

  2. 使用する Node.js インタープリターを指定します。

    プロジェクトエイリアスを選択すると、WebStorm は Node.js ページの Node インタープリターフィールドからプロジェクトの既定のインタープリターを自動的に使用します。ほとんどの場合、WebStorm はプロジェクトの既定のインタープリターを検出し、フィールド自体に入力します。

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

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

  3. 分度器パッケージの場所と protractor.conf.js 設定ファイルへのパスを指定します。標準インストールを実行した場合、WebStorm はこれらのパスをすべて検出して、対応するフィールドに表示します。

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

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

  1. Selenium サーバーを手動で起動するか、protractor.conf.js で自動的に起動するように構成します。詳細については、Protractor オフィシャル Web サイト(英語)を参照してください。

  2. 構成のリストから Protractor 実行 / デバッグ構成を選択し、リストまたはツールバーの the Run icon をクリックします。

    Select run/debug configuration
  3. 実行ツールウィンドウの <current_run_configuration_name> タブで、サーバーからのメッセージを表示および分析します。

ナビゲーション

WebStorm を使用すると、ファイルと関連テストファイルの間、またはテストランナータブのテスト結果からテストに移動できます。

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

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

デバッグテスト

Protractor テスト用のデバッグセッションは、実行 / デバッグ構成によってのみ開始されます。

デバッグテストを開始するには

  1. 上記のように Protractor 実行 / デバッグ構成を作成します。

  2. 構成のリストから Protractor 実行 / デバッグ構成を選択し、リストまたはツールバーの Run with Coverage をクリックします。

    Select run/debug configuration
  3. 開いたデバッグツールウィンドウで、通常どおりに進めます。プログラムをステップ実行し、プログラムの実行を停止および再開し中断されたときにそれを調べ、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、実際の HTML DOM を表示するなどします。

関連ページ:

プラグインのインストール

プラグインは WebStorm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。デフォルトでは、WebStorm には多数のプラグインがバンドルされています。バンドルされたプラグインを無効にするこ...

実行 / デバッグ構成ダイアログ

このダイアログを使用して、実行 / デバッグ構成を作成、編集、調整、削除したり、新しく作成されたすべての実行 / デバッグ構成に適用されるデフォルトのテンプレートを構成したりします。既存の実行 / デバッグ構成は、構成タイプごとにグループ化されています。新しい構成を作成するためのテンプレートは編集可能であり、ダイアログの左側のペインにある構成テンプレートの編集リンクから利用できます。共通設定:実行構成を編集するとき(ただし実行構成テンプレートは編集しないとき)、次のオプションを指定できます。名...

実行 / デバッグ構成: Protractor

作成: このページでは、構成固有の項目と、すべての実行 / デバッグ構成に共通のオプションについて説明します。この構成の使用方法の詳細については、「Protractor」を参照してください。このダイアログで、Protractor テストランナーを使用して AngularJS 単体テストを実行およびデバッグするための設定を作成します。始める前に:Node.js をダウンロードしてインストールします。Protractor のインストールの説明に従って、Protractor テストフレームワークをインスト...

リモート Node.js インタープリターの構成

WebStorm では、リモートホストまたは仮想環境にインストールされた Node.js でアプリケーションを開発、テスト、リント、実行、デバッグするときに、リモート Node.js インタープリターを構成する必要があります。リモート Node.js インタープリターは、Node.js リモートインタープリターの構成ダイアログで構成されます。このダイアログは、リモート環境でアプリケーションを実行またはデバッグするための Node.js 実行 / デバッグ構成を作成または編集するときに、設定ダイア...

Node.js

Node.js は、サーバーやコマンドラインなど、ブラウザーの外部で JavaScript を実行するための軽量ランタイム環境です。WebStorm は Node.js と統合されており、アプリケーションの構成、編集、実行、デバッグ、テスト、プロファイリング、保守を支援します。Node.js がアプリケーションのローカルランタイムとして、または npm パッケージの管理、JavaScript リンターの実行、ツールのビルド、フレームワークのテストなどにのみ必要な場合は、Node.js をインストール...

テストランナータブ

テストランナータブは、テストセッションの開始時に実行ツールウィンドウで開き、同じツールバーボタンを備えています。実行ツールバーは、実行ツールウィンドウのツールバーとほとんど同じですが、テスト固有のボタンを備えています。左側のペインには、現在の実行 / デバッグ構成内のすべてのテストのツリービューが表示されます。ルートノードは、実行するように選択されたテストを表します。ネストされたノードは、テストスイートとテストケースの階層を表します。リーフノードは個々のテストを表します。各テストのステータスはア...