TestCase
TestCase は、テストファイル内のすべての test() 呼び出しに対応します。単一の test() が複数のプロジェクトで実行されている場合、または複数回繰り返される場合、対応するプロジェクトのスイートに複数の TestCase オブジェクトが存在します。
メソッド
ok
バージョン v1.10 で追加テストが正常に実行されていると見なされるかどうかを示します。ok でないテストは、ゼロ以外の終了コードでテスト実行を失敗させます。
使用例
testCase.ok();
戻り値
outcome
バージョン v1.10 で追加このテストのテスト結果。 outcome は testResult.status と同じではないことに注意してください。
- 失敗することが予想され、実際に失敗したテストは
'expected'です。 - 2回目のリトライで合格したテストは
'flaky'です。
使用例
testCase.outcome();
戻り値
- "skipped" | "expected" | "unexpected" | "flaky"#
titlePath
バージョン v1.10 で追加ルートからこのテストまでのタイトルのリストを返します。
使用例
testCase.titlePath();
戻り値
プロパティ
annotations
バージョン v1.10 で追加現在のテストに適用可能なアノテーションのリスト。以下を含みます:
- test() および test.describe() を介してテストまたはスイートで定義されたアノテーション;
- test.skip(), test.fixme() および test.fail() メソッドによって暗黙的に追加されたアノテーション;
- テスト実行中に testInfo.annotations に追加されたアノテーション。
アノテーションは、テスト実行中に testInfo.annotations を通じて利用可能です。
テストアノテーション の詳細はこちらをご覧ください。
使用例
testCase.annotations
型
expectedStatus
バージョン v1.10 で追加期待されるテストステータス。
- test.skip() または test.fixme() としてマークされたテストは、
'skipped'になることが期待されます。 - test.fail() としてマークされたテストは、
'failed'になることが期待されます。 - その他のテストは、
'passed'になることが期待されます。
実際のステータスについては、 testResult.status も参照してください。
使用例
testCase.expectedStatus
型
- "passed" | "failed" | "timedOut" | "skipped" | "interrupted"
id
バージョン v1.25 で追加テストファイル名、テストタイトル、プロジェクト名に基づいて計算されるテスト ID。ID は Playwright セッション内で一意です。
使用例
testCase.id
型
location
バージョン v1.10 で追加テストが定義されているソース内の場所。
使用例
testCase.location
型
parent
バージョン v1.10 で追加このテストケースが属するスイート。
使用例
testCase.parent
型
repeatEachIndex
バージョン v1.10 で追加"repeat each" モードで実行している場合のリピートインデックスが含まれます。このモードは、 コマンドライン に --repeat-each を渡すことで有効になります。
使用例
testCase.repeatEachIndex
型
results
バージョン v1.10 で追加このテストの各実行の結果。
使用例
testCase.results
型
retries
バージョン v1.10 で追加構成でこのテストに与えられた最大リトライ回数。
テストリトライ の詳細はこちらをご覧ください。
使用例
testCase.retries
型
tags
バージョン v1.42 で追加test() または test.describe() を介してテストまたはスイートで定義されたタグのリスト、およびテストとスイートのタイトルから抽出された @-トークン。
テストタグ の詳細はこちらをご覧ください。
使用例
testCase.tags
型
timeout
バージョン v1.10 で追加テストに与えられたタイムアウト。testConfig.timeout, testProject.timeout, test.setTimeout(), test.slow() および testInfo.setTimeout() の影響を受けます。
使用例
testCase.timeout
型
title
バージョン v1.10 で追加test() 呼び出しに渡されたテストタイトル。
使用例
testCase.title
型
type
バージョン v1.44 で追加"test" を返します。suite.entries() でテストケースを検出するのに役立ちます。
使用例
testCase.type
型
- "test"