跳到主要内容

Suite

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

  • 根测试套件（Root suite）为每个FullProject 包含一个子测试套件。
    • 项目测试套件（Project suite） #1。为项目中的每个测试文件包含一个子测试套件。
      • 文件测试套件（File suite） #1
      • 文件测试套件（File suite） #2
      • < 更多文件测试套件 ... >
    • 项目测试套件（Project suite） #2
    • < 更多项目测试套件 ... >

在 reporter.onBegin() 方法中，报告器会获得一个根测试套件。

方法​

allTests​

新增于: v1.10 suite.allTests

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

用法

suite.allTests();

返回值

entries​

新增于: v1.44 suite.entries

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

用法

suite.entries();

返回值

project​

新增于: v1.10 suite.project

此测试套件所属项目的配置，对于根测试套件则为 void。

用法

suite.project();

返回值

titlePath​

新增于: v1.10 suite.titlePath

返回从根测试套件到此测试套件的标题列表。

用法

suite.titlePath();

返回值

属性​

location​

新增于: v1.10 suite.location

定义测试套件的源文件位置。根测试套件和项目测试套件缺失此属性。

用法

suite.location

类型

parent​

新增于: v1.10 suite.parent

父测试套件，根测试套件缺失此属性。

用法

suite.parent

类型

suites​

新增于: v1.10 suite.suites

子测试套件。请参阅 Suite 以了解测试套件的层级结构。

用法

suite.suites

类型

tests​

新增于: v1.10 suite.tests

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

用法

suite.tests

类型

title​

新增于: v1.10 suite.title

测试套件标题。

  • 根测试套件为空。
  • 项目测试套件的项目名称。
  • 文件测试套件的文件路径。
  • 传递给 test.describe() 的分组测试套件标题。

用法

suite.title

类型

type​

新增于: v1.44 suite.type

返回测试套件的类型。测试套件形成以下层级结构：root -> project -> file -> describe -> ...describe -> test。

用法

suite.type

类型

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