Suite

Suite 是一个测试组。 Playwright Test 中的所有测试都形成以下层级结构

• 根 suite 为每个 FullProject 都有一个子 suite。
  • 项目 suite #1。 为项目中的每个测试文件都有一个子 suite。
    • 文件 suite #1
      • TestCase #1
      • TestCase #2
      • Suite 对应于 test.describe() 组
        • TestCase #1 在一个组中
        • TestCase #2 在一个组中
      • < 更多测试用例 ... >
    • 文件 suite #2
    • < 更多文件 suites ... >
  • 项目 suite #2
  • < 更多项目 suites ... >

Reporter 在 reporter.onBegin() 方法中获得一个根 suite。

---

方法

allTests

添加于: v1.10 suite.allTests

返回此 suite 及其后代中所有测试用例的列表，与 suite.tests 相反。

用法

suite.allTests();

返回值

• Array<TestCase>#

---

entries

添加于: v1.44 suite.entries

直接在此 suite 中定义的测试用例和 suites。 元素按照声明顺序返回。 您可以使用 testCase.type 和 suite.type 来区分各种条目类型。

用法

suite.entries();

返回值

• Array<TestCase | Suite>#

---

project

添加于: v1.10 suite.project

此 suite 所属项目的配置，或者根 suite 的 void。

用法

suite.project();

返回值

• FullProject | [undefined]#

---

titlePath

添加于: v1.10 suite.titlePath

返回从根到此 suite 的标题列表。

用法

suite.titlePath();

返回值

• Array<string>#

---

属性

location

添加于: v1.10 suite.location

suite 定义在源文件中的位置。 根和项目 suites 缺失。

用法

suite.location

类型

• Location

---

parent

添加于: v1.10 suite.parent

父 suite，根 suite 缺失。

用法

suite.parent

类型

• Suite

---

suites

添加于: v1.10 suite.suites

子 suites。 有关 suites 的层级结构，请参阅 Suite。

用法

suite.suites

类型

• Array<Suite>

---

tests

添加于: v1.10 suite.tests

suite 中的测试用例。 请注意，列表中仅包含直接在此 suite 中定义的测试用例。 在嵌套的 test.describe() 组中定义的任何测试用例都列在子 suite.suites 中。

用法

suite.tests

类型

• Array<TestCase>

---

title

添加于: v1.10 suite.title

Suite 标题。

• 根 suite 为空。
• 项目 suite 的项目名称。
• 文件 suite 的文件路径。
• 传递给 test.describe() 以用于组 suite 的标题。

用法

suite.title

类型

• string

---

type

添加于: v1.44 suite.type

返回 suite 的类型。 Suites 形成以下层级结构: root -> project -> file -> describe -> ...describe -> test。

用法

suite.type

类型

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