Seleniumことはじめ 〜Assertion〜
Assertionとは、アプリケーションの動作結果が期待しているものと合致しているか検証するためのコマンドのこと。Assertionには以下の3つのモデルがあります。
| assert | 失敗した場合、テストは中止されます |
|---|---|
| verify | 失敗した場合、失敗はログに記録されてテストは継続実施されます |
| waitFor | 条件が満たされることを待ちます（Ajaxのテストに有効）。条件が既に満たされている場合は直ちに検証成功となります。しかし、現在のタイムアウト設定の時間内に条件が満たされなかった場合には検証失敗となり、テストを中止します |
Selenium IDE では、右クリックから Assertion メニューを開いた際に、「Toggle verify/assert」で切り替えることができます（waitForは無いみたい）。
Assertion コマンド一覧
何が検証できるのか整理してみました。「assertXxxx」は、「verifyXxxx」「waitForXxxx」と指定することも可能です。
| コマンド | 検証内容 |
|---|---|
| assertLocation assertNotLocation |
現在のページの絶対URL |
| assertTitle assertNotTitle |
現在のページのタイトル |
| assertText assertNotText |
要素のテキスト文字列 |
| assertTextPresent assertTextNotPresent |
ページのどこかに表示されているテキスト文字列パターン |
| assertBodyText assertNotBodyText |
そのページのテキスト全体 |
| assertValue assertNotValue |
入力フィールド及びvalueパラメータを持つ要素の(空白整形された)値 |
| assertEval assertNotEval |
指定したJavascriptの評価結果 |
| assertSelected assertNotSelected |
ドロップダウンのselect要素にて選択したopotion要素がoptionLocatorとマッチしているか |
| assertChecked assertNotChecked |
トグルボタン(チェックボックス/ラジオボタン)の選択状態 |
| assertTable assertNotTable |
table要素のセルアドレスを指定してのテキスト文字列 |
| assertSelectedLabels assertNotSelectedLabels |
指定したselect要素(複数選択可能なものも含む)にて選択されている全てのoption要素のラベル(表示されるテキスト文字列) |
| assertSelectedLabel assertNotSelectedLabel |
指定したselect要素において選択されているoption要素のラベル(表示されるテキスト文字列) |
| assertSelectedValues assertNotSelectedValues |
指定したselect要素(複数選択可能なものを含む)にて選択されている全てのoption要素のvalue属性値 |
| assertSelectedValue assertNotSelectedValue |
指定したselect要素にて選択されているoption要素のvalue属性値 |
| assertSelectedIndexes assertNotSelectedIndexes |
指定したselect要素(複数選択可能なものを含む)にて選択されている全てのoption要素のインデックス(0から始まるoptionの順番) |
| assertSelectedIndex assertNotSelectedIndex |
指定したselect要素にて選択されているoption要素のインデックス(0から始まるoptionの順番) |
| assertSelectedIds assertNotSelectedIds |
指定したselect要素(複数選択可能なものを含む)にて選択されている全てのoption要素のid属性値 |
| assertSelectedId assertNotSelectedId |
指定したselect要素にて選択されているoption要素のid属性値 |
| assertSomethingSelected assertNotSomethingSelected |
select要素でいずれかのoption要素が選択されているかどうか |
| assertSelectOptions assertNotSelectOptions |
指定したselect要素に含まれる全てのoption要素 |
| assertAttribute assertNotAttribute |
要素のattribute(属性)値 |
| assertElementPresent assertElementNotPresent |
指定した要素がそのページのどこかにあるかどうか |
| assertVisible assertNotVisible |
指定した要素が表示されているかどうか |
| assertEditable assertNotEditable |
指定したinput要素が編集可能かどうか |
| assertAlert assertNotAlert |
alertの発生（メッセージ指定あり） |
| assertAlertPresent assertAlertNotPresent |
alertの発生 |
| assertPrompt assertNotPrompt |
promptの発生（メッセージ指定あり） |
| assertPromptPresent assertPromptNotPresent |
promptダイアログの発生 |
| assertConfirmation assertNotConfirmation |
confirm()メソッドの呼び出し（メッセージ指定あり） |
| assertConfirmationPresent assertConfirmationNotPresent |
confirm()メソッドの呼び出し |
| assertAllButtons assertNotAllButtons |
指定したid配列のボタンがあるかどうか |
| assertAllLinks assertNotAllLinks |
指定したid配列のリンクがあるかどうか |
| assertAllFields assertNotAllFields |
指定したid配列の入力フィールドがあるかどうか |
| assertHtmlSource assertNotHtmlSource |
htmlタグで括られた全てのHTMLソース |
| assertCursorPosition assertNotCursorPosition |
指定したinput要素またはテキストエリアにおけるカーソル位置 |
| assertExpression assertNotExpression |
指定した表現（avaScriptのプリプロセッシングのために有効） |
引数などの詳細については、「Selenium リファレンスガイド（日本語版）」 を参考にしてください。
