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

TestCase

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


メソッド

ok

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

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

使用法

testCase.ok();

戻り値


outcome

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

このテストのテスト結果です。outcometestResult.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 (オプション)

      オプションの説明。


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"