23.3.6 TestSuite オブジェクト

23.3.6 TestSuite オブジェクト

TestSuiteオブジェクトはTestCaseとよく似た動作をしますが、実際のテストは実装せず、一まとめにに実行するテストのグループをまとめるために使用します。TestSuiteには以下のメソッドが追加されています:

addTest( test): TestCase又はTestSuiteのインスタンスをスイートに追加します。

addTests( tests): イテラブルtestsに含まれる全てのTestCase又は TestSuiteのインスタンスをスイートに追加します。
このメソッドはtest上のイテレーションをしながらそれぞれの要素に addTest()を呼び出すのと等価です。

TestSuiteクラスはTestCaseと以下のメソッドを共有します:

run( result): スイート内のテストを実行し、結果をresultで指定した結果オブジェクトに収集します。TestCase.run()と異なり、 TestSuite.run()では必ず結果オブジェクトを指定する必要があります。

debug( ): このスイートに関連づけられたテストを結果を収集せずに実行します。これによりテストで送出された例外は呼び出し元に伝わるようになり、デバッガの下でのテスト実行をサポートできるようになります。

countTestCases( ): このテストオブジェクトによって表現されるテストの数を返します。これには個別のテストと下位のスイートも含まれます。

通常、TestSuiteのrun()メソッドはTestRunnerが起動するため、ユーザが直接実行する必要はありません。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。