# Protractor

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

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

## 始める前に

Procedure:

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

2. JavaScript および TypeScript  と  Angular および AngularJS  に必要なプラグインが   設定 | プラグイン   ページで有効化されていることを確認してください。 詳細については、 [プラグインの管理](managing-plugins.html)を参照してください。

## Protractor をインストールする

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

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

1. コマンドライン シェルまたは組み込みの   ターミナルエミュレータ  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）で、次を入力します：

`npm install -g protractor`

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

## テストを実行

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

Procedure: Protractor 実行構成を作成する

1. [実行 / デバッグ構成](run-debug-configurations-dialog.html)ダイアログ (メインメニューの  `実行 | 実行構成の編集​`  ) を開き、左側のペインで ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/デバッグ構成：Protractor](run-debug-configuration-protractor.html)ダイアログが開きます。

> **Tip:**
> または、   プロジェクト   ツールウィンドウ（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) ）でテストファイルを選択し、コンテキストメニューから   <ファイル名> を作成；   を選択します。

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

プロジェクト   エイリアスを選択すると、CLion は   ノードランタイム   フィールドの [JavaScript ランタイム](javascript-runtime.html)ページからプロジェクトデフォルトのインタープリターを自動的に使用します。 ほとんどの場合、CLion はプロジェクトのデフォルトランタイムを検出し、フィールドに自動的に入力します。

別の構成済みローカルインタープリターを選択するか、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックして新しいものを構成することもできます。

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

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

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

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

2. 構成の一覧から Protractor 実行/デバッグ構成を選択し、一覧またはツールバーの ![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックします。

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

## ナビゲーション

CLion を使えば、ファイルと関連するテストファイルの間や、 [テストランナータブ](null)のテスト結果からテストにジャンプできます。

Procedure:

* テストとそのサブジェクト間、またはその逆に移動するには、エディターでファイルを開き、コンテキストメニューから  `Go to | テスト`  または  `Go to | テスト対象`  を選択するか、 `Ctrl+Shift+T` (Windows), `⌘ ⇧ T` (macOS), `⌘ ⇧ T` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ T` (macOS System Shortcuts), `Ctrl+Shift+T` (XWin), `Ctrl+Shift+T` (GNOME), `Ctrl+Shift+T` (KDE), `Ctrl+Shift+T` (Emacs), `Ctrl+Shift+T` (Sublime Text), `Ctrl+Shift+T` (Sublime Text (macOS)), `⌘ ⇧ T` (Xcode), `Ctrl+Shift+T` (Visual Studio), `Ctrl+Shift+T` (Visual Studio (macOS)), `Ctrl+Shift+T` (ReSharper), `Ctrl+Shift+T` (ReSharper (macOS)), `Ctrl+Shift+T` (QtCreator), `Ctrl+Shift+T` (QtCreator (macOS)), `Ctrl+Shift+T` (NetBeans), `Ctrl+Shift+T` (Eclipse), `Ctrl+Shift+T` (Eclipse (macOS)) を押します。

* テスト結果からテスト定義に移動するには、「   テストランナー   」タブでテスト名を 2 回クリックするか、コンテキストメニューから「  `ソースに移動`  」を選択するか、単に `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) を押します。 テストファイルがエディターで開き、テスト定義にキャレットが置かれます。

## デバッグテスト

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

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

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

2. 構成の一覧から Protractor 実行/デバッグ構成を選択し、一覧またはツールバーの ![カバレッジで実行](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) をクリックします。

3. 開いた [デバッグツールウィンドウ](debug-tool-window.html)で、通常通りに操作します。 [プログラムをステップ実行](stepping-through-the-program.html)し、 [実行を停止や再開](null)し、中断時は [プログラムを確認](examining-suspended-program.html)、コールスタックと変数を調査し、ウォッチを設定し、変数を評価し、 [実際の HTML DOM を表示](viewing-actual-html-dom.html)などが行えます。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

## See also

### リファレンス

[実行 / デバッグ構成: Protractor](run-debug-configuration-protractor.html)

