Suite

Suite 是一组测试。Playwright Test 中的所有测试均形成以下层次结构：

¥Suite is a group of tests. All tests in Playwright Test form the following hierarchy:

• 根套件为每个 TestProject 都有一个子套件。

  ¥Root suite has a child suite for each TestProject.

  • 项目套件#1。项目中的每个测试文件都有一个子套件。

    ¥Project suite #1. Has a child suite for each test file in the project.

    • 文件套件 #1

      ¥File suite #1

      • TestCase#1

      • TestCase#2

      • 对应 test.describe() 组的组曲

        ¥Suite corresponding to a test.describe() group

        • TestCase 小组第一

          ¥TestCase #1 in a group

        • TestCase 小组中排名第 2

          ¥TestCase #2 in a group

< 更多测试用例 ... >

• 文件套件 #2

  ¥File suite #2

< 更多文件套件 ... >

• 项目套件#2

  ¥Project suite #2

< 更多项目套件 ... >

报告器在 reporter.onBegin() 方法中得到了一个根套件。

¥Reporter is given a root suite in the reporter.onBegin() method.

---

方法

¥Methods

allTests

Added in: v1.10 suite.allTests

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

¥Returns the list of all test cases in this suite and its descendants, as opposite to suite.tests.

用法

¥Usage

suite.allTests();

返回

¥Returns

• Array<TestCase>#

---

project

Added in: v1.10 suite.project

该套件所属项目的配置，或根套件的 void。

¥Configuration of the project this suite belongs to, or void for the root suite.

用法

¥Usage

suite.project();

返回

¥Returns

• TestProject#

---

titlePath

Added in: v1.10 suite.titlePath

返回从根到该套件的标题列表。

¥Returns a list of titles from the root down to this suite.

用法

¥Usage

suite.titlePath();

返回

¥Returns

• Array<string>#

---

属性

¥Properties

location

Added in: v1.10 suite.location

定义套件的源中的位置。缺少根套件和项目套件。

¥Location in the source where the suite is defined. Missing for root and project suites.

用法

¥Usage

suite.location

类型

¥Type

• Location

---

parent

Added in: v1.10 suite.parent

父套件，根套件缺失。

¥Parent suite, missing for the root suite.

用法

¥Usage

suite.parent

类型

¥Type

• Suite

---

suites

Added in: v1.10 suite.suites

子套件。请参阅 Suite 了解套件的层次结构。

¥Child suites. See Suite for the hierarchy of suites.

用法

¥Usage

suite.suites

类型

¥Type

• Array<Suite>

---

tests

Added in: v1.10 suite.tests

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

¥Test cases in the suite. Note that only test cases defined directly in this suite are in the list. Any test cases defined in nested test.describe() groups are listed in the child suite.suites.

用法

¥Usage

suite.tests

类型

¥Type

• Array<TestCase>

---

title

Added in: v1.10 suite.title

套件标题。

¥Suite title.

• 根套件为空。

  ¥Empty for root suite.

• 项目套件的项目名称。

  ¥Project name for project suite.

• 文件套件的文件路径。

  ¥File path for file suite.

• 群组套件的所有权已移交给 test.describe()。

  ¥Title passed to test.describe() for a group suite.

用法

¥Usage

suite.title

类型

¥Type

• string