IntelliJ IDEA 2026.1 Help

Protractor

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

始める前に

  1. Node.js をダウンロードしてインストールします。

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

  3. Angular および AngularJS プラグインを 設定 | プラグイン ページ、 Marketplace タブでインストールし有効化してください。詳しくは JetBrains Marketplace からプラグインをインストールするをご覧ください。 このプラグインは IntelliJ IDEA Ultimate でのみ利用可能です。

Protractor をインストールする

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

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

  1. 組み込み ターミナル (Alt+F12) で次のように入力します。

    npm install -g protractor

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

テストの実行

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

Protractor 実行構成を作成する

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

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

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

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

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

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

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

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

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

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

ナビゲーション

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

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

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

デバッグテスト

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

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

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

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

  3. 開いた デバッグツールウィンドウ で、通常どおり続行します: プログラムをステップ実行しプログラムの実行を停止して再開し中断時に調べ 、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、 実際の HTML DOM を表示します。

2026 年 3 月 30 日