QUnit API

• QUnit API

QUnit API

テストを実行するメソッド

• test( name, expected, test )
  • テストを実行します。test関数の中では最低一つ以上のアサーションメソッドが実行される必要があります。
  • アサーションメソッドを呼ばない場合、その事でエラーになることはありません。

• asyncTest( name, expected, test )
  • 非同期にテストを実行します。テスト終了後にstop()メソッドを呼ぶ為、必ずtest関数の中でstart()を呼ぶ必要があります。
  • start()を呼ばない場合、アサーションメソッドは実行されません(その事でエラーにはなりません)

• expect( amount )
  • テストに成功した回数を検知します。多くても少なくてもテストに失敗します。

• module( name, lifecycle )
  • テストモジュール名を定義する関数です。。module()関数を呼ぶと、次にmodule()関数を記述するまでに定義された関数は、全て前のmodule()に所属します。
  • lifecycleオブジェクトの中にsetup()関数とtearDown()関数を含めておくと、モジュールに所属するテスト関数が開始する前にsetup()関数が、テストの終了後にtearDown()関数が、各テスト関数の開始ごとにそれぞれ呼び出されます。

• QUnit.init( )
  • テストケースの初期化を行うメソッド(通常は明示的に呼ぶ必要はありません)

• QUnit.reset( )
  • ブラウザでテストしている場合、#mainまたは#qunit-fixture要素を初期状態に戻します。
  • 各テストの終了ごとに自動的に呼ばれます。
    
    テストのアサーションメソッド

• ok( state, message )

• equal( actual, expected, message )
  「actual==expected」であればパス

• notEqual( actual, expected, message )
  • 「actual!=expected」であればパス

• deepEqual( actual, expected, message )
  • actualとexpectedのプロパティを再帰的に比較して、全て等しければパス
  • Array、Object型の詳細な比較に用いる

• notDeepEqual( actual, expected, message )
  • actualとexpectedのプロパティを再帰的に比較して、違うものがあればパス
  • Array、Object型の詳細な比較に用いる

• strictEqual( actual, expected, message )
  • 「actual === expected」であればパス

• notStrictEqual( actual, expected, message )
  • 「actual !== expected」であればパス

• raises( state, message )
  • 関数が例外を投げるかどうかをテストするアサーション関数

非同期テストで利用するメソッド

• start( )
  • 一時停止したテストを再開します。
• stop( count )
  • テストを一時停止します。