测试用例

TestCase 对应于测试文件中每个 test() 调用。当单个 test() 在多个项目中运行或重复多次时，它将在相应项目的套件中具有多个 TestCase 对象。

---

方法

ok

新增于：v1.10 testCase.ok

测试是否被认为运行良好。非 ok 测试将导致测试运行以非零退出代码失败。

用法

testCase.ok();

返回值

• 布尔值#

---

结果

新增于：v1.10 testCase.outcome

此测试的测试结果。请注意，结果与 testResult.status 不同。

• 预期失败并实际失败的测试为 'expected'。
• 在第二次重试中通过的测试为 'flaky'。

用法

testCase.outcome();

返回值

• "skipped" | "expected" | "unexpected" | "flaky"#

---

标题路径

新增于：v1.10 testCase.titlePath

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

用法

testCase.titlePath();

返回值

• 数组<字符串>#

---

属性

注释

新增于：v1.10 testCase.annotations

适用于当前测试的注释列表。包括

• 通过 test() 和 test.describe() 在测试或套件上定义的注释；
• 由方法 test.skip()、test.fixme() 和 test.fail() 隐式添加的注释；
• 附加到 testInfo.annotations 的注释，在测试执行期间。

通过 testInfo.annotations 在测试执行期间可以使用注释。

了解有关 测试注释 的更多信息。

用法

testCase.annotations

类型

• 数组<对象>

  • type 字符串

    注释类型，例如 'skip' 或 'fail'。

  • description 字符串 (可选)

    可选说明。

---

预期状态

新增于：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

类型

• 字符串

---

位置

新增于：v1.10 testCase.location

定义测试的源代码中的位置。

用法

testCase.location

类型

• 位置

---

父级

新增于：v1.10 testCase.parent

此测试用例所属的套件。

用法

testCase.parent

类型

• 套件

---

repeatEach 索引

新增于：v1.10 testCase.repeatEachIndex

在“重复每个”模式下运行时包含重复索引。此模式通过将 --repeat-each 传递到 命令行 来启用。

用法

testCase.repeatEachIndex

类型

• 数字

---

结果

新增于：v1.10 testCase.results

此测试每次运行的结果。

用法

testCase.results

类型

• 数组<测试结果>

---

重试次数

新增于：v1.10 testCase.retries

在配置中为此测试提供的最大重试次数。

了解有关 测试重试 的更多信息。

用法

testCase.retries

类型

• 数字

---

标签

新增于：v1.42 testCase.tags

通过 test() 或 test.describe() 在测试或套件上定义的标签列表，以及从测试和套件标题中提取的 @ 令牌。

了解有关 测试标签 的更多信息。

用法

testCase.tags

类型

• 数组<字符串>

---

超时

新增于：v1.10 testCase.timeout

给定测试的超时时间。受 testConfig.timeout、testProject.timeout、test.setTimeout()、test.slow() 和 testInfo.setTimeout() 影响。

用法

testCase.timeout

类型

• 数字

---

标题

新增于：v1.10 testCase.title

传递给 test() 调用的测试标题。

用法

testCase.title

类型

• 字符串

---

类型

新增于：v1.44 testCase.type

返回“test”。用于在 suite.entries() 中检测测试用例。

用法

testCase.type

类型

• "test"