Ael.test.Assertクラス
説明
テスト結果を確認する機能を提供します。また確認結果が全て期待通りか否かの状態を持ちます。このクラスとAel.test.TestCaseクラスはセットであり、単体で使用することはありません。
コンストラクタ
prototype initialize(Ael.test.TestCase testcase) : void
- @version 0.3
- @param {Ael.test.TestCase} testcase テストケース
引数の値からAssertオブジェクトを生成して返す。
instanceプロパティ
expectedValues
instance expectedValues : object
- @version 0.3
テストケースに対する期待値。
successful
instance successful : boolean
- @version 0.3
断定結果を示すフラグ。
全て成功の場合は true。一つでも失敗した場合は false。
testcase
instance testcase : Ael.test.TestCase
- @version 0.3
テストケース。
prototypeプロパティ
assertTrue
prototype assertTrue(boolean actual, string message) : void
- @version 0.3
- @param {boolean} actual 結果値
- @param {string} message アサートメッセージ
結果値が true であることを断定する。
結果値の確認後はリスナーのメソッドを呼び出す。断定が成功した場合はonAssertSuccessfulメソッドを呼び出し、失敗した場合はonAssertFailureメソッドを呼び出す。
assertFalse
prototype assertFalse(boolean actual, string message) : void
- @version 0.3
- @param {boolean} actual 結果値
- @param {string} message アサートメッセージ
結果値が false であることを断定する。
結果値の確認後はリスナーのメソッドを呼び出す。断定が成功した場合はonAssertSuccessfulメソッドを呼び出し、失敗した場合はonAssertFailureメソッドを呼び出す。
assertNaN
prototype assertNaN(boolean actual, string message) : void
- @version 0.3
- @param {number} actual 結果値
- @param {string} message アサートメッセージ
結果値が予約値のNaN定数であることを断定する。
組み込み関数のisNaN()は値が数値以外かどうかを判定しますが、このメソッドはNaN定数かどうかを判定します。結果値の確認後はリスナーのメソッドを呼び出す。断定が成功した場合はonAssertSuccessfulメソッドを呼び出し、失敗した場合はonAssertFailureメソッドを呼び出す。
assertEquals
prototype assertEquals(any expected, any actual, string message) : void
- @version 0.3
- @param {any} expected 期待値
- @param {any} actual 結果値
- @param {string} message アサートメッセージ
二つの値が等しい（===）ことを断定する。
結果値の確認後はリスナーのメソッドを呼び出す。断定が成功した場合はonAssertSuccessfulメソッドを呼び出し、失敗した場合はonAssertFailureメソッドを呼び出す。
assertNotEquals
prototype assertEquals(any expected, any actual, string message) : void
- @version 0.3
- @param {any} expected 期待値
- @param {any} actual 結果値
- @param {string} message アサートメッセージ
二つの値が等しくない（!==）ことを断定する。
結果値の確認後はリスナーのメソッドを呼び出す。断定が成功した場合はonAssertSuccessfulメソッドを呼び出し、失敗した場合はonAssertFailureメソッドを呼び出す。
assertArrayEquals
prototype assertEquals(Array expected, Array actual, string message) : void
- @version 0.3
- @param {Array} expected 期待値
- @param {Array} actual 結果値
- @param {string} message アサートメッセージ
二つの配列が持つ値が全て等しい（===）ことを断定します。
結果値の確認後はリスナーのメソッドを呼び出す。断定が成功した場合はonAssertSuccessfulメソッドを呼び出し、失敗した場合はonAssertFailureメソッドを呼び出す。
assertWith
prototype assertWith(any expectedMin, any expectedMax, any actual, string message) : void
- @version 0.4
- @param {any} expectedMin 期待値の範囲（最小）
- @param {any} expectedMax 期待値の範囲（最大）
- @param {any} actual 結果値
- @param {string} message アサートメッセージ
結果値が期待した範囲内（最小 <= 期待値 <= 最大）であることを断定します。
結果値の確認後はリスナーのメソッドを呼び出す。断定が成功した場合はonAssertSuccessfulメソッドを呼び出し、失敗した場合はonAssertFailureメソッドを呼び出す。
assertPropertiesEquals
prototype assertEquals(object expected, object actual, string message) : void
- @version 0.3
- @param {object} expected 期待値
- @param {object} actual 結果値
- @param {string} message アサートメッセージ
二つの値が持つプロパティが全て等しい（===）ことを断定する。
結果値の確認後はリスナーのメソッドを呼び出す。断定が成功した場合はonAssertSuccessfulメソッドを呼び出し、失敗した場合はonAssertFailureメソッドを呼び出す。
expect
prototype expect(object|number values) : void
- @version 0.3
- @param {object|number} values 期待値
テストケースに対する期待値を設定する。
期待値には次の項目を指定することができる。数値型で指定した場合はamount項目を指定したと同じになる。
| 値名 | 型 | 初期値 | 説明 |
| amount | number | -1 | 期待するアサート数。実際のアサート数が期待値以上になるまでテストケースの実行を続ける。マイナス値で無効になる。 |
| clearTimer | boolean | false | テストケース終了時にテストケース内で登録(setTimeout、setInterval)したタイマーをクリアする。 |
| timeout | number | -1 | タイムアウト時間。実行時間がタイムアウト時間を経過するとアサーション失敗で終了する。マイナス値で無効になる。 |
fail
prototype fail(string message) : void
- @version 0.4
- @param {string} message アサートメッセージ
強制的に失敗とする。
assertXxxメソッドで失敗した時と同様にonAssertFailureメソッドを呼び出す。
