メインコンテンツにスキップ

TestCase

TestCase は、テストファイル内のすべての test() 呼び出しに対応します。単一の test() が複数のプロジェクトで実行されたり、複数回繰り返されたりする場合、対応するプロジェクトのスイート内に複数の TestCase オブジェクトが存在します。


メソッド

ok

追加バージョン: v1.10 testCase.ok

テストが問題なく実行されたと見なされるかどうか。ok でないテストは、ゼロ以外の終了コードでテスト実行を失敗させます。

使用法

testCase.ok();

戻り値


outcome

追加バージョン: v1.10 testCase.outcome

このテストのテスト結果。結果は testResult.status とは異なります。

  • 失敗すると予想され、実際に失敗したテストは 'expected' です。
  • 2回目のリトライで合格したテストは 'flaky' です。

使用法

testCase.outcome();

戻り値

  • "skipped" | "expected" | "unexpected" | "flaky"#

titlePath

追加バージョン: v1.10 testCase.titlePath

ルートからこのテストまでのタイトルリストを返します。

使用法

testCase.titlePath();

戻り値


プロパティ

annotations

追加バージョン: v1.10 testCase.annotations

最後のテスト実行の testResult.annotations

使用法

testCase.annotations

タイプ

  • Array<Object>
    • type string

      アノテーションタイプ。例えば 'skip' または 'fail'

    • description string (オプション)

      オプションの説明。

    • location Location (オプション)

      アノテーションが追加されたソース内のオプションの場所。


expectedStatus

追加バージョン: v1.10 testCase.expectedStatus

期待されるテストステータス。

  • test.skip() または test.fixme() としてマークされたテストは 'skipped' となることが期待されます。
  • test.fail() としてマークされたテストは 'failed' となることが期待されます。
  • その他のテストは 'passed' となることが期待されます。

実際のステータスについては testResult.status も参照してください。

使用法

testCase.expectedStatus

タイプ

  • "passed" | "failed" | "timedOut" | "skipped" | "interrupted"

id

追加バージョン: v1.25 testCase.id

テストファイル名、テストタイトル、プロジェクト名に基づいて計算されたテストID。このIDはPlaywrightセッション内で一意です。

使用法

testCase.id

タイプ


location

追加バージョン: v1.10 testCase.location

テストが定義されているソース内の場所。

使用法

testCase.location

タイプ


parent

追加バージョン: v1.10 testCase.parent

このテストケースが属するスイート。

使用法

testCase.parent

タイプ


repeatEachIndex

追加バージョン: v1.10 testCase.repeatEachIndex

"repeat each" モードで実行している場合の繰り返しインデックスを格納します。このモードは、コマンドライン--repeat-each を渡すことで有効になります。

使用法

testCase.repeatEachIndex

タイプ


results

追加バージョン: v1.10 testCase.results

このテストの各実行の結果。

使用法

testCase.results

タイプ


retries

追加バージョン: v1.10 testCase.retries

このテストに設定で与えられたリトライの最大回数。

テストのリトライについて詳しくはこちら。

使用法

testCase.retries

タイプ


tags

追加バージョン: v1.42 testCase.tags

test() または test.describe() を介してテストまたはスイートに定義されたタグのリスト、およびテストタイトルとスイートタイトルから抽出された @-トークン。

テストタグについて詳しくはこちら。

使用法

testCase.tags

タイプ


timeout

追加バージョン: v1.10 testCase.timeout

テストに与えられたタイムアウト。testConfig.timeouttestProject.timeouttest.setTimeout()test.slow()testInfo.setTimeout() の影響を受けます。

使用法

testCase.timeout

タイプ


title

追加バージョン: v1.10 testCase.title

test() 呼び出しに渡されたテストタイトル。

使用法

testCase.title

タイプ


type

追加バージョン: v1.44 testCase.type

"test"を返します。suite.entries()でテストケースを検出するのに役立ちます。

使用法

testCase.type

タイプ

  • "test"