スイートルーム？ スウィートルーム？
はじめに Selenium-IDE 統合開発環境 は、Selenium テストケースを開発するためのツールです。 Selenium-IDE は使いやすい Firefox プラグインで、一般にテストケースを開発するための最も効率的な方法です。 Selenium-IDE ではコンテキストメニューも使用できます。 コンテキストメニューを使うと、まず現在ブラウザに表示されているページ上の UI 要素を選択し、次に Selenium コマンドのリストから目的のコマンドを選択できます。 コマンドのパラメータは、選択された UI 要素のコンテキストに従って、あらかじめ定義されたものが使われます。 Selenium-IDE を使う方法は、時間の節約になるだけでなく、Selenium スクリプトの構文を学ぶ手段としても優れています。 この章では Selenium-IDE について詳しく取り上げ、Selenium-IDE を効果的に使う方法について説明します。 メニューバー [ファイル] メニューでは、テストケースファイルやテストスイートファイルを新規作成したり、開いたり、保存したりできます。 [編集] メニューでは、テストケースのコマンドをコピー、貼り付け、削除したり、操作を元に戻したり、コマンドをすべて選択したりできます。 [オプション] メニューでは、さまざまな設定を変更できます。 一部のコマンドのタイムアウト値を設定したり、Selenium のコマンドの基本セットを拡張するユーザー定義の拡張スクリプトを追加したり、作成したテストケースを保存するときのフォーマット 言語 を指定したりできます。 [ヘルプ] メニューは Firefox 標準の [ヘルプ] メニューで、この中の [UI-Element Documentation] だけが Selenium-IDE に関係のある項目です。 ツールバー ツールバーには、テストケースをデバッグするためのステップ実行機能をはじめ、テストケースの実行をコントロールするためのさまざまなボタンが並んでいます。 右端の赤い丸のボタンは、[Record] 記録 ボタンです。 [Speed Control] 速度調節 : テストケースの実行速度を調節します。 [Run All] すべて実行 : 複数のテストケースを持つテストスイートが読み込まれているときにテストスイート全体を実行します。 [Run] 実行 : 現在選択されているテストを実行します。 テストが 1 つしか読み込まれていない場合、このボタンと [Run All] ボタンの動作は同じです。 [Step] ステップ実行 : コマンドを 1 つずつ実行し、テストケースの「1ステップ実行」を行います。 テストケースをデバッグするときに使います。 [TestRunner Mode] TestRunner モード : テストケースを Selenium-Core TestRunner で読み込んでブラウザで実行することができます。 TestRunner は今はあまり使われておらず、いずれ非推奨となるでしょう。 このボタンは、テストケースを評価して、TestRunner との後方互換性があるかどうかを調べるために用意されています。 ほとんどのユーザーは、このボタンを使う必要はないでしょう。 [Apply Rollup Rules] ロールアップルールを適用 : この高度な機能を利用すると、一連の Selenium コマンドの繰り返しを 1 つのアクションにまとめることができます。 ロールアップルールの詳細については、[ヘルプ] メニューの [UI-Element Documentation] を参照してください。 [Record] 記録 : ユーザーのブラウザ操作を記録します。 [テストケース] ペイン スクリプトは [テストケース] ペインに表示されます。 [テストケース] ペインには 2 つのタブがあります。 次に示すのは、コマンドとそのパラメータを読みやすい「テーブル」形式で表示するための [テーブル] タブです。 もう 1 つの [ソース] タブには、テストケースがネイティブ形式で表示されます。 ファイルはこのネイティブ形式で保存されます。 デフォルトでは HTML ですが、Java や C などのプログラミング言語、あるいは Python などのスクリプト言語に変更することもできます。 詳細については、[オプション] メニューを参照してください。 [ソース] タブでは、テストケースを生の形式で編集することができ、操作のコピー、切り取り、貼り付けが可能です。 [コマンド]、[対象]、および [値] 入力フィールドには、現在選択されているコマンドとそのパラメータが表示されます。 これらの入力フィールドでは、現在選択されているコマンドを修正できます。 一番下のペインの [リファレンス] タブで、コマンドに対して指定されている 1 つ目のパラメータは、必ず [対象] フィールドに入力します。 [リファレンス] タブで 2 つ目のパラメータが指定されている場合、このパラメータは [値] フィールドに入力します。 [コマンド] フィールドに文字を入力すると、入力した文字に応じてドロップダウンリストに項目が表示されるので、このリストから目的のコマンドを選択できます。 [リファレンス] [リファレンス] タブは、[テーブル] タブで Selenese コマンドとパラメータを入力したり修正したりする場合にデフォルトで選択されるタブです。 [テーブル] タブが表示されている場合、[リファレンス] ペインには現在のコマンドのリファレンスが表示されます。 [テーブル] タブの [ソース] タブのどちらで作業している場合も、コマンドを入力または修正するときは、[対象] フィールドと [値] フィールドで指定するパラメータが、[リファレンス] ペインのパラメータリストに指定されているものと一致していることを確認することが非常に重要です。 指定するパラメータの数は、[リファレンス] ペインで指定されている数と一致しなければならず、パラメータの順序も [リファレンス] ペインのそれと一致しなければなりません。 さらに、指定するパラメータの型も、[リファレンス] ペインで指定されている型と一致していなければなりません。 これら 3 つのうち、1 つでも一致しないものがあれば、コマンドは正常に実行されません。 [リファレンス] タブはクイックリファレンスとして大いに役立ちますが、Selenium を参照することもしばしば必要になります。 ノート ユーザー拡張スクリプトを使えば、デフォルトでオフにすることができます。 記録中は、ユーザーの操作に基づいて Selenium-IDE がテストケースにコマンドを自動的に挿入します。 次に示すのは、典型的なユーザーの操作です。 リンクをクリックする - click コマンドまたは clickAndWait コマンド• 値を入力する - type コマンド• ドロップダウンリストボックスで項目を選択する - select コマンド• チェックボックスまたはラジオボタンをクリックする - click コマンド いくつか注意すべき点を次に示します。 type コマンドが記録されるようにするには、Web ページ上のどこか別の場所をクリックする操作が必要になる場合があります。 リンクをたどる操作は、通常は click コマンドとして記録されます。 多くの場合、 click コマンドは clickAndWait に変更して、新しいページが完全に読み込まれるまでテストケースを確実に停止させる必要があります。 そうしないと、ページに含まれるすべての UI 要素が読み込まれる前にテストケースの実行が先に進み、予期しない形でテストケースが失敗することになります。 コンテキストメニューを使った検証とアサートの追加 テストケースでは、Web ページのプロパティをチェックする必要もあるでしょう。 それには、 assert コマンドと verify コマンドを使う必要があります。 ここでは、これらのコマンドの細かな点には触れません。 テストケースに追加する方法だけを説明します。 コマンドの詳細については、 に関する章を参照してください。 Selenium-IDE の記録機能がオンの状態で、テスト対象のアプリケーションを表示しているブラウザを選択し、ページ上の任意の場所を右クリックします。 すると、 verify コマンドや assert コマンドを含むコンテキストメニューが表示されます。 初めて Selenium を使う場合には、Selenium コマンドが 1 つしか表示されないかもしれません。 しかし、IDE を使っていると、メニューに表示されるコマンドがどんどん増えていきます。 Selenium-IDE は、現在の Web ページ上で選択されている UI 要素に応じて、必要なコマンドとパラメータの予測を試みます。 実際にこの機能をためしてみましょう。 適当な Web ページを開き、ページ上のテキストを選択します。 段落 1 つか、見出しがいいでしょう。 次に、選択したテキストを右クリックします。 コンテキストメニューが表示され、 verifyTextPresent コマンドと、このコマンドにふさわしいパラメータとして、選択されたテキスト自体が表示されるはずです。 また、[利用可能な全てのコマンド] という項目があることに注目してください。 この項目を選択すると、非常に多くのコマンドが、現在選択されている UI 要素のテストに適したパラメータ案とともに表示されます。 いくつかほかの UI 要素についても、同じようにためしてみてください。 たとえば、画像を右クリックしたり、ボタンやチェックボックスなどのユーザーコントロールを右クリックしたりしてみてください。 verifyTextPresent 以外のオプションを見るには、[利用可能な全てのコマンド] を使う必要があるかもしれません。 いったんほかのオプションを選択すると、よく使われるコマンドがトップレベルのコンテキストメニューに表示されるようになります。 たとえば、画像に対して verifyElementPresent を選択すると、次に画像を選択して右クリックしたときに、トップレベルのコンテキストメニューにこのコマンドが表示されるようになります。 繰り返しになりますが、これらのコマンドの詳細については、Selenium のコマンドに関する章で説明します。 とりあえずここでは、IDE を使ってさまざまなコマンドをテストケースに記録、選択し、テストケースを実行してみてください。 IDE を使っていうちに、Selenium のコマンドについても自然に多くのことを学べるはずです。 テストケースの実行 Selenium-IDE には、テストケースを実行するためのさまざまなオプションがあり、1 つのテストケースの実行、停止と再開、1 行ずつの実行、現在開発中のコマンドだけの実行、テストスイート全体の実行などが可能です。 Selenium-IDE では、テストケースを非常に柔軟に実行できます。 テストケースの実行 [Run] ボタンをクリックすると、現在表示されているテストケースが実行されます。 テストスイートの実行 [Run All] ボタンをクリックすると、現在読み込まれているテストスイートに含まれるすべてのテストケースが実行されます。 停止と再開 [Pause] ボタンをクリックすると、実行中のテストケースを停止できます。 テストケースの実行を停止すると、ボタンのアイコンは [Resume] ボタンのアイコンに変わります。 実行を再開するには、[Resume] ボタンをクリックします。 途中で実行を停止 テストケース内でブレークポイントを指定すると、特定のコマンドでテストケースを停止することができます。 この機能は、テストケースをデバッグするときに便利です。 途中から実行を開始 テストケースの途中にある特定のコマンドから実行を開始することができます。 この機能も、テストケースをデバッグするときに便利です。 任意のコマンドの実行 1 つのコマンドだけをダブルクリックすると、そのコマンドを実行することができます。 この機能は、コマンドを 1 つ記述するときに便利です。 作成中のコマンドが適切かどうかわからないときでも、コマンドを即座にテストできます。 コマンドをダブルクリックするだけで、適切に実行されるかどうか確認できます。 この機能は、コンテキストメニューからも利用できます。 Base URL を使った、異なるドメインでのテストケースの実行 Selenium-IDE ウィンドウの上部にある [Base URL] フィールドを使うと、テストケースを異なるドメインで実行できるので便利です。 portal. news. portal. com という名前でインハウスのベータサイトを持っていたとします。 この場合、これらのサイトが対象で、 open ステートメントで始まるすべてのテストケースについて、 open の引数に 絶対 URL http: または https: などのプロトコルで始まる URL ではなく、 相対 URL を指定します。 すると、Selenium-IDE は、[Base URL] フィールドに入力された値の最後に、 open コマンドの引数を追加して、絶対 URL を作成します。 portal. html を対象に実行されます。 news. portal. html を対象に実行されます。 ブレークポイントと開始位置 Selenium-IDE では、テストケース内の任意の位置でテストケースの実行を開始または停止するためのブレークポイントの指定と開始位置の指定がサポートされています。 この機能を使うと、テストケースの途中の特定のコマンドでテストケースの実行を停止させ、その時点でのテストケースの動作を調べることができます。 この場合、具体的には、調べようとするコマンドの直前のコマンドにブレークポイントを指定します。 テストケースを最初からブレークポイントまで実行するには、[Run] ボタンをクリックします。 テストケースの途中から最後まで、または最初からブレークポイントまでの部分を実行できると便利なことがあります。 たとえば、最初に Web サイトにログインし、次に一連のテストを実行するテストケースを作成していて、ログイン後の一連のテストのいずれかをデバッグしたい場合などです。 この場合、ログインは 1 度すれば不要になりますが、その後のテストは繰り返し実行する必要があります。 このようなテストケースでは、いったんログインした後、ログイン操作の後に開始位置を指定し、この開始位置からテストケースを実行することができます。 こうすれば、テストケースを再実行するたびに手動で Web サイトからログアウトする必要はなくなります。 テストケースを開始位置から実行するには、[Run] ボタンをクリックします。 [検索] ボタン [検索] ボタンを使うと、現在 ブラウザに 表示されている Web ページ上の UI 要素のうち、現在選択されている Selenium コマンドで使われているのはどの UI 要素かを知ることができます。 この機能は、コマンドの最初のパラメータでロケータを使う場合に便利です Selenium のコマンドに関する章の「 」を参照。 [検索] ボタンは、Web ページ上の UI 要素を指定する必要があるあらゆるコマンド、すなわち click 、 clickAndWait 、 type 、および一部の assert と verify コマンドなどで使用できます。 [テーブル] タブで、ロケータパラメータを持ついずれかのコマンドを選択します。 [検索] ボタンをクリックします。 Firebox ブラウザに表示されている Web ページに注目します。 ロケータパラメータで指定されている要素が、明るい緑の四角で囲んで表示されます。 デバッグ時のページソースの参照 テストケースをデバッグするときは、しばしばページソース テスト対象の Web ページの HTML を参照して問題を解決しなければなりません。 Firefox では、ページソースも簡単に参照できます。 具体的には、目的の Web ページを右クリックし、[ページのソースを表示] を選択するだけです。 これで、ソースの HTML が別のウィンドウに表示されます。 テスト対象の UI 要素を HTML から見つけるためのキーワードを検索するには、このウィンドウの [編集] メニューにある [検索] を使ってください。 また、ソースを見たい Web ページの一部を選択し、右クリックして表示されるメニューから [選択した部分のソースを表示] をクリックする方法もあります。 この場合は、ソースの一部だけが別のウィンドウに表示され、選択した部分が強調表示されます。 ロケータアシスタンス Selenium-IDE は、ロケータ型引数を記録するたびに追加情報を保存し、この追加情報を使って、代わりに使用できるほかのロケータ型引数をユーザーに提示できるようにしています。 この機能は、ロケータについて詳しく学ぶ上で非常に有益なだけでなく、記録された型とは異なる型のロケータを使う場合にしばしば必要となります。 ロケータアシスタンスは、Selenium-IDE ウィンドウ内の [対象] フィールドの右端にドロップダウンリストとして表示されます ドロップダウンリストが表示されるのは、[対象] フィールドに入力されている引数が、記録されたロケータ型引数である場合だけです。 次に示すのは、あるコマンドのドロップダウンリストの内容です。 ドロップダウンリストの最初の列には、代わりに使用できるロケータが表示され、2 列目にはそれぞれの型が表示されることに注意してください。 テストスイートの作成 テストスイートとはテストケースの集合のことで、Selenium-IDE ウィンドウの一番左にある [テストスイート] ペインに表示されます。 [テストスイート] ペインを手動で開いたり閉じたりするには、[テストケース] ペインの右端 ペインが閉じている場合は Selenium-IDE ウィンドウ全体の左端になります の半分ほど下にある小さな点を選択します。 [テストスイート] ペインは、既存のテストスイートが開かれるか、 または ユーザーが [ファイル] メニューの [テストケースを新規作成] をクリックすると、自動的に開きます。 後者の場合、新しいテストケースは直前のテストケースのすぐ下に表示されます。 既存のテストケースをテストスイートに読み込む操作は、Selenium-IDE ではまだサポートされていません。 既存のテストケースを追加して、テストスイートを作成または修正するには、ユーザーが手動でテストスイートファイルを編集する必要があります。 テストスイートファイルは、1 列のテーブルを含む HTML ファイルです。 セクション内の各行のセルには、テストケースへのリンクが収められています。 次に示すのは、4 つのテストケースを含むテストスイートの例です。 Sample Selenium Test Suite Test Cases for De Anza A-Z Directory Links A Links B Links C Links D Links ユーザー拡張スクリプト ユーザー拡張スクリプトは、ユーザー独自のカスタマイズや機能を作成して Selenium の機能を拡張できる JavaScript ファイルです。 多くの場合、コマンドのカスタマイズという形を取りますが、ユーザー拡張スクリプトによる機能拡張はコマンドの追加だけに限定されません。 ユーザーが作成した多くの有益な があります。 おそらく Selenium-IDE のすべての拡張スクリプトの中で最も人気があるのは、while ループとプリミティブな条件判定によってフロー制御を可能にする でしょう。 この拡張スクリプトの使用例については、作者が用意した ［訳注：リンク切れです］を参照してください。 この拡張スクリプトをインストールするには、Selenium-IDE の [オプション] メニューで [設定] をクリックし、 [一般] タブの [Selenium Core 拡張スクリプト user-extension. js のパス] フィールドに、ファイルのパス名を入力します。 [OK] ボタンをクリックしたら、拡張スクリプトを読み込むために、Selenium-IDE をいったん閉じて開く必要があります。 また、拡張スクリプトに変更を加えた場合も、Selenium-IDE をいったん閉じて開く必要があります。 独自の拡張スクリプトを作成する方法については、Selenium ドキュメントの終わりの方に説明があります。 フォーマット 形式 [オプション] メニューの [設定] をクリックすると表示される [フォーマット] タブでは、テストケースの保存と表示に使う言語を選択できます。 デフォルトは [HTML] です。 作成したテストケースを Selenium-RC を使って実行する場合には、作成されたテストケースをプログラミング言語に変換するためにこの機能が使われます。 テストプログラムの開発用に Selenium-RC で使う言語 [Java]、[PHP] など を選択し、次に [ファイル] メニューの [保存] を使ってテストケースを保存します。 これで、テストケースは、選択した言語の一連の関数に変換されます。 テストをサポートするプログラムコードは、基本的に、ユーザーに代わって Selenium-IDE によって生成されます。 生成されたコードが自分のニーズに合わないときは、生成プロセスが定義された設定ファイルを編集することで、生成されるコードを変更できることに注意してください。 サポートされている言語ごとに設定があり、これらの設定を編集できます。 設定は、[オプション] メニューの [設定] をクリックすると表示される [フォーマット] タブにあります。 トラブルシューティング 以下は、Selenium-IDE で発生することが多いさまざまな問題について、実際の画面を示しながら説明したものです。 この問題は、Selenium-IDE を初めて実行したときに発生することがあります。 解決策は Selenium-IDE をいったん閉じて開き直すことです。 このバグは として登録されています。 [ファイル] メニューの [開く] を使ってテストスイートファイルを開こうとしました。 [ファイル] メニューの [テストスイートを開く] を使ってください。 この種の error は、タイミングの問題で起きることがあります。 たとえば、コマンドのロケータで指定されている要素が、コマンドが実行された時点ではまだ完全に読み込まれていなかった、などです。 エラーが発生したコマンドの前に pause 5000 を入力して、問題がタイミングに関するものなのかどうか切り分けてみてください。 上の open コマンドのように、変数による置き換えを使おうとすると必ず失敗する場合は、使おうとしている値を格納する変数が、実際には作成されていないことを示します。 多くの場合、 [対象] フィールドに入力する必要がある変数を [値] フィールドに入力しているか、またはその逆にしていることが原因です。 上の例の場合、 store コマンドの 2 つのパラメータの入力順序が間違っています。 どの Selenese コマンドの場合も、最初の必須パラメータは [対象] フィールドに、2 つ目の必須パラメータ 必要な場合 は [値] フィールドに入力する必要があります。 テストスイート内のいずれかのテストケースが見つかりません。 該当するテストケースが、テストスイートで指定されている場所に実際に存在するかどうか確認してください。 また、実際のテストケースファイルの拡張子が. html になっているかどうか、さらに、呼び出し元のテストスイートファイル内でも、該当するテストケースファイルの拡張子が. html になっているかどうか確認してください。 Selenium-IDE では 空白の有無が非常に重要 です。 コマンドの前後に余計な空白があると、コマンドとして認識されません。 Selenium-IDE は拡張スクリプトファイルの内容を読み込むことができませんでした。 [オプション] メニューの [設定] をクリックすると表示される [一般] タブの [Selenium Core 拡張スクリプト user-extension. js のパス] フィールドに、拡張スクリプトへの適切なパス名が入力されているかどうか確認してください。 また、拡張スクリプトファイルに変更を加えた場合も、 [Selenium Core 拡張スクリプト user-extension. js のパス] フィールドの内容を変更した場合も、Selenium-IDE を再起動する必要があります。 この種のエラーメッセージは、エラーがないのに Selenium-IDE がエラーメッセージを表示しているように見えます。 しかし、実際の値が、テストケースで指定された値と一致していないという点については、Selenium-IDE に間違いはありません。 問題は、ログファイルのエラーメッセージでは 2 つ以上の空白が 1 つに圧縮されていて、どの部分がエラーになったのかわかりにくい点にあります。 一方、ページの実際のタイトルでは、これらの単語の間には空白が 1 つしかありません。 Selenium-IDE がエラーを生成したのはこのためです。
次の
