Selenium
Selenium(英語) は、Web ブラウザーの対話を自動化するために広く使用されているオープンソースのテストフレームワークです。 このフレームワークはさまざまな Web ブラウザーとプラットフォームをサポートしているため、包括的な Web アプリケーションのテストに多用途に使用できます。
Selenium サポートにより、Java、Kotlin、Groovy、Python での自動テスト用の専用プロジェクトを作成できます。 依存関係管理には Maven または Gradle を選択できます。 テストケースを管理するには、 TestNG または JUnit を選択できます。
新しい Selenium プロジェクトを作成する
メインメニューで へ移動します。 または、 ようこそ 画面を表示している場合は、 新規プロジェクト をクリックします。
左側のリストから Selenium を選択します。
新しいプロジェクトに名前を付け、必要に応じてその場所を変更します。
(オプション) Git リポジトリの作成 オプションを有効にして、新しいプロジェクトをバージョン管理下に置きます。 今すぐ実行したくない場合は、後でいつでも実行できます。
使用する 言語 を選択します。
(オプション) グループ および アーティファクト パラメーターを変更します。
JDK リストから、プロジェクトで使用する JDK を選択します。
JDK がコンピューターにインストールされているが、IDE で定義されていない場合は、 JDK を追加 を選択し、JDK ホームディレクトリへのパスを指定します。
必要な JDK がコンピューターにない場合は、 JDK のダウンロード を選択します。
(オプション) サンプルコードの追加 パラメーターを有効にします。
次へ をクリックします。
使用する Selenium バージョンを選択し、必要な依存関係を追加します。
作成 をクリックします。
ようこそ 画面で 新規プロジェクトの作成 をクリックするか、メインメニューから を選択します。 新規 プロジェクト ダイアログが開きます。
左側のリストから Selenium と Pytest を選択します。
新しいプロジェクトに名前を付け、必要に応じてその場所を変更します。
(オプション) Git リポジトリの作成 オプションを有効にして、新しいプロジェクトをバージョン管理下に置きます。 今すぐ実行したくない場合は、後でいつでも実行できます。
環境 を新規に作成するか既存のものを使用するかを選択し、対応する設定を構成します。
リストから基本インタープリターを選択するか、
をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。場所 フィールドに新しい仮想環境の場所を指定するか、
をクリックしてファイルシステム内の場所を参照します。 新しい仮想環境のディレクトリは空である必要があります。マシン上のグローバル Python にインストールされているすべてのパッケージを、これから作成する仮想環境に追加する場合は、 ベースインタープリターからパッケージを継承する},{ チェックボックスを選択します。 この チェックボックス は、 virtualenv ツールの
--system-site-packagesオプションに対応しています。IntelliJ IDEA で Python インタープリターを作成するときにこの環境を再利用する場合は、 すべてのプロジェクトで使用可能にする チェックボックスを選択します。
詳細については、 PyCharm のドキュメントを参照してください。
ロケーション フィールドに新しい conda 環境の場所を指定するか、
をクリックしてファイルシステム内の場所を参照します。 新しい conda 環境のディレクトリは空である必要があります。リストから Python のバージョンを選択します。
IntelliJ IDEA は conda のインストールを検出します。
IntelliJ IDEA がインストールを自動的に検出しなかった場合は、conda 実行可能ファイルの場所を指定するか、
をクリックして参照します。IntelliJ IDEA で Python インタープリターを作成するときにこの環境を再利用する場合は、 すべてのプロジェクトで使用可能にする チェックボックスを選択します。
詳細については、 PyCharm のドキュメントを参照してください。
リストから基本インタープリターを選択するか、
をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。ベースバイナリディレクトリを
PATH環境変数に追加した場合、追加のオプションを設定する必要はありません。pipenv 実行可能ファイルへのパスは自動検出されます。IntelliJ IDEA が pipenv 実行可能ファイルを検出しない場合は、 pip 経由で pipenv をインストールする をクリックして、IntelliJ IDEA が自動的にインストールできるようにします。
または、 pipenv のインストール手順に従って実行可能パスを検出し、それをダイアログで指定します。
詳細については、 PyCharm のドキュメントを参照してください。
リストからインタープリターを選択します。 利用可能なインタープリターがない場合は、 インタープリターの追加 をクリックし、必要に応じてインタープリターを構成します。
作成 をクリックします。
選択したオプションに従って新しいプロジェクトが作成されます。
コードに要素を追加する
要素を追加するファイルを開きます。
右側のサイドバーの
をクリックして、 Web インスペクター ツールバーウィンドウを開きます。アドレスバーにページの URL を指定します。
「
」をクリックし、Web インスペクターで追加する要素を選択します。
要素を選択したら、「
」をクリックして要素をコードに追加します。
特定のタイプのセレクター (ID、 名前、 クラスでタグ付けするなど) を追加するには、
をクリックして必要なオプションを選択します。
CSS ロケーターと XPath ロケーターの間で具体的に切り替える場合は、
をクリックして、必要なロケーター型を選択します。
その結果、コードの一部が生成され、コードエディターに追加されます。
テストの実行
テストを実行するには、テストクラスまたはテストメソッドの横にある
ガターアイコンをクリックし、リストから 実行 オプションを選択します。
あるいは、キャレットをテストクラスに置いてそのクラス内のすべてのテストを実行するか、テストメソッドにキャレットを置き、 Ctrl+Shift+F10 を押します。
実行 / デバッグ構成を使用すると、よりカスタマイズ可能な方法でテストを実行できます。 詳細については、 テストの実行 を参照してください。
テスト結果を確認する
テストの実行が終了すると、結果が 実行 ツールウィンドウの テストランナー タブに表示されます。 このタブでは、テストの再実行、テスト結果のエクスポートとインポート、各テストの実行にかかった時間を確認したり、その他のアクションを実行したりできます。
詳細については、 テスト結果を調べる を参照してください。
デバッグテスト
一般に、デバッグ手順には次の手順が含まれます。
実行を一時停止する必要があるコード行にブレークポイントを設定します。
コードをデバッグモードで実行します。
デバッグ ツールウィンドウを使用してコードを分析し、潜在的な問題を特定します。
問題を修正します。
IDE でこれらの手順を再現するには、次の手順を実行します。
ガター内で、実行可能ファイルの行にカーソルを合わせ、実行を一時停止したい場所で
をクリックします。 
ガターの
をクリックして デバッグ を選択します。 これでデバッガー セッションが開始され、コードが実行されます。 プログラムがブレークポイントで停止すると、実行が中断され、デバッガー セッションの結果を デバッグ ツールウィンドウで確認できます。
デバッグの詳細については、「コードのデバッグ 」を参照してください。
実行 / デバッグ構成を変更する
テストの起動プロパティを変更する場合は、実行 / デバッグ構成を編集します。
実行 / デバッグ構成スイッチャーで現在の構成をクリックし、 構成の編集(R)… オプションを選択します。
実行 / デバッグ構成 ダイアログで、編集する構成を選択します。
必要なスタートアッププロパティを構成します。
変更を適用して OK をクリックします。
実行/デバッグ構成の詳細については、 実行 / デバッグ構成 を参照してください。
ロケーターテンプレートをカスタマイズする
選択した要素をコードに追加する方法をカスタマイズしたい場合は、テンプレートを変更できます。
ステータスバーのフレームワーク名をクリックします。 UI オートメーションフレームワーク メニューが開きます。
テンプレートのカスタマイズ オプションを選択してください。
ファイルおよびコードテンプレート ダイアログで、リストから必要なフレームワークを選択します。
Web 要素ロケーターのコード生成アルゴリズムを書き換えます。
変更を保存するには、 OK をクリックします。
その結果、更新されたコード生成アルゴリズムに従ってロケーターがコードに追加されます。
クロスブラウザーテストにソレノイドを使用する
Selenoid(英語) は、Docker 用の Selenium ハブの実装であり、Docker コンテナーで実行されている Web ブラウザーで自動テストを実行できます。 Selenoid は、テストごとに、指定された Web ブラウザー、環境、設定を使用してコンテナーを作成します。
Docker で Selenoid を実行する
エディターで browsers.json ファイルを開きます。
エディター上部のパネルで、 起動 をクリックします。
IDE は、必要なすべてのコンテナーをブラウザーでプルし、メインのソレノイドコンテナーを実行して管理します。
ログやビデオの出力先フォルダーなど、Selenoid 実行構成設定で使用できる追加オプションがあります。 これらのオプションにアクセスするには、 browsers.json ファイルを開いたときに、エディターの上のペインで 構成 をクリックします。 オプションの詳細な説明については、 Docker 実行構成 を参照してください。