Suite

Suite はテストのグループです。Playwright Test のすべてのテストは、次の階層を形成します。

• ルートスイートには、FullProject ごとに子スイートがあります。
  • プロジェクトスイート #1。プロジェクト内の各テストファイルの子スイートがあります。
    • ファイルスイート #1
      • TestCase #1
      • TestCase #2
      • test.describe() グループに対応するスイート
        • TestCase グループ #1
        • TestCase グループ #2
      • < その他のテストケース... >
    • ファイルスイート #2
    • < その他のファイルスイート... >
  • プロジェクトスイート #2
  • < その他のプロジェクトスイート... >

Reporter には、reporter.onBegin() メソッドでルートスイートが与えられます。

---

メソッド

allTests

v1.10 で追加 suite.allTests

suite.tests とは対照的に、このスイートとその子孫のすべてのテストケースのリストを返します。

使用法

suite.allTests();

戻り値

• Array<TestCase>#

---

entries

v1.44 で追加 suite.entries

このスイートで直接定義されたテストケースとスイート。要素は宣言された順序で返されます。testCase.type と suite.type を使用して、さまざまなエントリタイプを区別できます。

使用法

suite.entries();

戻り値

• Array<TestCase | Suite>#

---

project

v1.10 で追加 suite.project

このスイートが属するプロジェクトの構成、またはルートスイートの場合は void。

使用法

suite.project();

戻り値

• FullProject | [undefined]#

---

titlePath

v1.10 で追加 suite.titlePath

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

使用法

suite.titlePath();

戻り値

• Array<string>#

---

プロパティ

location

v1.10 で追加 suite.location

スイートが定義されているソース内の場所。ルートスイートとプロジェクトスイートでは欠落しています。

使用法

suite.location

型

• Location

---

parent

v1.10 で追加 suite.parent

親スイート。ルートスイートでは欠落しています。

使用法

suite.parent

型

• Suite

---

suites

v1.10 で追加 suite.suites

子スイート。Suite でスイートの階層構造を参照してください。

使用法

suite.suites

型

• Array<Suite>

---

tests

v1.10 で追加 suite.tests

スイート内のテストケース。このスイートで直接定義されたテストケースのみがリストに含まれていることに注意してください。ネストされた test.describe() グループで定義されたテストケースは、子 suite.suites にリストされています。

使用法

suite.tests

型

• Array<TestCase>

---

title

v1.10 で追加 suite.title

スイートのタイトル。

• ルートスイートの場合は空。
• プロジェクトスイートのプロジェクト名。
• ファイルスイートのファイルパス。
• グループスイートの test.describe() に渡されるタイトル。

使用法

suite.title

型

• string

---

type

v1.44 で追加 suite.type

スイートのタイプを返します。スイートは次の階層を形成します：root -> project -> file -> describe -> ...describe -> test。

使用法

suite.type

型

• "root" | "project" | "file" | "describe"