2005.10.4 update!

・version 0.6でました。Selenium Recorderの紹介も含め、詳しくはコチラ。

■Selenium って何？

　これっていわゆる、Webアプリケーションのテストツールというらしいです。例えばPerlとかで組んだCGIとか、PHP・ASP・JSPとか、ブラウザで動くプログラムを作ると必ず動作テストやりますよね（やらない？）　プログラムをちょっと修正するたびに「あれーどっか壊れてないかなー」と何回も同じような操作をチェックするために、ブラウザでポチポチやらなきゃいかんわけです。面倒でしょ？

　それを簡略化してくれるのがSelenium。自動化したい操作を、HTMLのテーブルタグにちょいちょい、と書いてあげれば後はガシガシ動いてくれるわけ。便利そうじゃない？　「おっ？スッゲーっ！！」と思ったヒトは、とりあえずもう少し先まで読んでみてくれ。

■さっそく試してみたいんだけどー。

　Seleniumを動かすのに最低限HTMLとJavaScriptは分かってほうがいいと思う。Webアプリ組めるヒトならある程度大丈夫かな？んじゃ早速。えーっと、とりあえず公式サイトから Selenium をDLしてくれ。デモみたい人はコチラからどうぞー。

・Selenium オフィシャル
http://selenium.thoughtworks.com/index.html

解凍するとreadmeとdocフォルダ、seleniumフォルダが展開されるはず。seleniumフォルダの中にはテストを走らせる為に必要な色んなファイルが入ってるけど、とりあえずデモを見てみましょう。/selenium/index.html をブラウザで開くと上の画面みたいなのが開くはず。とりあえず何も考えずに右上の「All Tests」ボタンを押してみよう。おおおおっっ！？

とまぁ、こういうことが出来るのだ。なんとなーく動き見てると設定ファイルの書き方わかるっしょ（ｗ　こういうことしたいなーと思ったときはとりあえずサンプルのテストを見てみると良さげ。

じゃあ、早速自作のプログラムもテストしてみようよ。seleniumフォルダをテストしたいプログラムがアップされてるディレクトリに放り込もう。例えば /cgi-bin/bbs.cgi をテストしたいんだったら /cgi-bin/selenium/ みたいに。

んで、次は自動化させたいブラウザ操作を設定ファイルに書いていこう。設定ファイルっつってもただのHTMLファイルなので気構えなくてよし。Dreamweaverとかでサクサク書いてしまおう。

１）テストを書いて /tests に放り込む。例えば TestTest.html など。
２）/tests/TestSuite.html のテーブルに新しい行を作って、TestTest.htmlへのリンクを貼る。
３）TestRunner.html をブラウザで開くとTestTest.htmlへのリンクが見えているのでクリック。
４）「Selected Test」ボタンを押すと、お！動いてる〜

相対パスやフォームの名前付けなんかで苦労する場合があるけど、そのときはDOMモデルを思い浮かべながら記述を見直してトライ。

■気がついたら書き込むコーナー

・RunしたときXxxAndWaitだとうまく動かないですよ？

複数のフレームを読ませたりしてるとガチャることがあるっぽい。そんな時はいちいち pause 300 とか指定してマス。

・idも何も振ってないimageボタンをクリックする、という暴挙

全くSeleniumを知らない世代に生まれたWebアプリには、idなぞ知らぬ！というフォームオブジェクトが居らっしゃってウゼー。そういう訳で勢い余って Xpath で指示してみた。上から数えて3番目のテーブルの8行目7列目の画像をクリックさせる場合、例えばこんな指定になる。

xpath=//table[2]//tr[7]/td[6]//img

テストを走らせてる際に、最初のxpath指定のテスト行を通過すると ｳﾝﾄｺﾄﾞｯｺｲｼｮ とxpathパーサを起動するために否応ナシに5秒ほど待たされる（ﾍﾟﾝﾃｨｱﾑ4ﾃﾞｽﾖ!）のがナニですが、どうしても押したいプッシュしたい！って方はどぞー。

⇒FUJITSU 技術情報 XPath
http://xml.fujitsu.com/jp/tech/xpath/

⇒XML Path Language (XPath)バージョン 1.0 和訳
http://www.infoteria.com/jp/contents/xml-data/REC-xpath-19991116-jpn.htm

■思いつきで言ってみる

・SQLとか使えないよねー？

　例えばショッピングカート作ってて新しいお客さんを登録させたいとき、新規IDをDBから引っ張ってこなきゃ無理な場合とか。力技でAjaSQL（http://ajasql.org/）という手もあるけど、PHPを動かせないとイカンのでやや面倒かも。あー！TestTest.htmlとかに直にサーバサイドで書いちゃえばいいじゃん！えーと.htmlでCGI/PHP/ASP/JSPが起動するようにサーバを設定（.htaccessとかで）し直してやって、DB繋いてSQL発行して新規IDゲットしたら、javascriptの変数にゴリっと代入文にダイレクトに

var jsNewID = ＜%=新規ID %＞;

みたいな。あとは

type - newID - javascript{ jsNewID }

とかでイけるんじゃなかろうか？　今度暇なときにやってみよう、このコンボは使えるかも？

・入れ子のフレームからPOPウィンドウってどう捕まえるの？

POPウィンドウの中までテスト処理を追っかけてやりたい場合、selectWindowでウィンドウ名を指定しなきゃいけないんだけど、入れ子のフレームだとマジ面倒くさい。結局こんな感じで書いて解決しました。

selectWindow - mainFrame.leftFrame.popWindow -

window.focus()使ったりしてたんで正直Seleniumが追っかけてくれるかどうか微妙だったけど、何食わぬ顔でテスト処理を続行してくれた。すごいぞSelenium。

・テスト書くのが....ダルイです

んーWebStoryUnitみたいにサーバのフィルタに記録用のルーチン差し込んでリクエストを横取りしてテストを生成・・・という訳にはいかないのだよなぁ。なんかこう録画ボタン一発でなんか出来ないかね、マックロード万歳。録画したい画面を子フレームに表示させてevalとかでオブジェクト監視して状態変わったらとか・・・・えーと、考えます(;´Д｀)

■情報源

・Selenium オフィシャル
http://selenium.thoughtworks.com/index.html

・川o・-・）＜2nd life - webアプリケーションテストツール seleniumがヤバすぎる
http://d.hatena.ne.jp/secondlife/20050525/1116947520

・プチツール - selenium Processor
http://www.iburiworks.com/petittools/slp.html

■Selenium Actions

アクションはアプリケーションに対して何か動作を行うようにSeleniumに知らせるものです。一般にこれらはユーザが行う何らかの動作を表します。

多くの Actionsは"AndWait"接尾語を付けてコールできます。この接尾語は「アクションを起動させてブラウザがサーバに通信を行い新しいページがロードされるのを（次のコマンドに移る前に）待つべきである」とSeleniumに知らせるためのものです。 このパターンへの例外は「open」と「click」です。これらはデフォルトの動作でページがロードされるのを待ちます。

■Selenium Checks

チェックは、アプリケーションの状態について確認するために使用されます。フォームの各フィールド値や何らかのテキストの状態、または現在のページのURLをチェックするためにこれらを使用します。Selenium チェックには「assert」および「verify」の2つのモードがあります。「assert」チェックが失敗するとテストが中止されることを除いては、これらは同様に振る舞います。「verify」チェックが失敗した場合、テストは実行を続行します。「assert」の単独チェックによって正しいページにあることを保証された後に「verify」チェックによるフォームのフィールド値やラベルなどのテストが続きます。

■ パラメータ構成と値

　すべてのSeleniumコマンドの引数は、単純な置換変数？と完全なjavascriptの両方を使って構成することができます。したがって、異なった構文を使用することでアクセスする場合を除いて、以前に格納された変数に、これらのメカニズムの双方からアクセスすることができます。

・ 格納された変数

　コマンド「storeValue」「storeText」「store」を使うと、後からアクセスするための変数を格納することができます。内部的には値が変数名によって合わせられている状態で、これらの変数は「storedVars」と呼ばれるマップに格納されます。これらのコマンドはコマンドリファレンスを参照してください。

・ 置換変数？

置換変数？はコマンドパラメタに以前に格納された変数への簡単なアクセスを提供します。このメカニズムは簡単なもので、代入する変数は $variableName で示されます。静的なテキストと共に複数の変数を代入して、混在させることができます。

・ Javascriptによる演算値

コマンドの引数にJavascriptによる演算値を用いることで、javascriptの出力をコマンドの引数に指定することできます。このメカニズムを使用するにはコマンドの引数に、以下のように記述します。

javascript{ （Javascriptの演算） }

ブラケット(｛ ｝)の中のテキストがjavascript表現として評価されます。また上で述べたstoredVarsマップを使うことで、以前に格納された変数として使うことでアクセスすることができます。なお、置換変数？をJavascriptによる再演算と結合ができないことに注意してください。

■Seleniumの拡張

あなた自身が作成したAction/Check/LocatorStrategyiesを追加することで、とても簡単にSeleniumを拡張できます。これにはSeleniumオブジェクトやPageBotオブジェクトのプロトタイプが記述されたJavascriptにメソッドを加える作業が必要です。Seleniumの起動時に、これらのプロトタイプのメソッドを自動的に走査し、名前パターンを使って Actions/Checks/LocatorStrategyies を認識します。

・Action

Seleniumのプロトタイプに定義された do××× と名付けられる全てのメソッドはActionとして追加されます。また、それぞれのActionには ×××AndWait もメソッドとして登録されます。Actionメソッドは最大2つまでの引数を、テストを定義したテーブルの2列目・3列目から取得できます。

例:
Seleniumに Action "typeRepeated" を追加すると、Seleniumがテキストボックスにテキストを「二度」タイプします。

・Checks

Seleniumのプロトタイプに定義された assert××× と名付けられるメソッドは全てCheckとして追加されます。また、それぞれのCheckには assert××× もメソッドとして登録されます。Checkメソッドは最大2つまでの引数を、テストを定義したテーブルの2列目・3列目から取得できます。

例:
確実に「検証したいテキストが繰り返し入力」されるかをチェックする"valueRepeated"を追加します。この場合テストで利用可能なコマンドは、assertValueRepeatedとverifyValueRepeatedとなります。

・LocatorStrategyies

PageBotのプロトタイプに定義された locateElementBy××× と名付けられる全てのメソッドはロケータ定義として追加されます。 ロケータ定義は2つの引数を取ります。最初の引数は与えられた文字列から接頭語を除いた文字列に、次の引数は探索するドキュメント名？になります。

例:
"valuerepeated="指示子を追加すると、与えられた値と等しい属性値が繰り返されたときの最初の要素を検索します。

■user-extensions.js

デフォルトでは、Seleniumは "user-extensions.js" というファイルを探して、その中のjavascriptコードを読み込みます。このファイルはSeleniumのコアを変更することなく新たな機能を追加するのに便利です。なお、標準のディストリビューションではこのファイルは存在していません。ユーザーは一般的な位置にこのファイルを作成することで、Seleniumソースを変更する必要無く、独自の拡張コードを置くことができます。これはまた、アップグレード作業の際にも有望となる手助けになるでしょう。