跳到主要内容

TestCase

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

方法​

ok​

添加于版本：v1.10 testCase.ok

指示测试是否被认为是正常运行。非 ok 测试会导致测试运行失败并返回非零退出代码。

用法

testCase.ok();

返回值

outcome​

添加于版本：v1.10 testCase.outcome

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

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

用法

testCase.outcome();

返回值

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

titlePath​

添加于版本：v1.10 testCase.titlePath

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

用法

testCase.titlePath();

返回值

属性​

annotations​

添加于版本：v1.10 testCase.annotations

应用于当前测试的注解列表。包括

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

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

用法

testCase.annotations

类型

  • Array<Object>

    • type string

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

    • description string (可选)

      可选的描述。

expectedStatus​

添加于版本：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

类型

location​

添加于版本：v1.10 testCase.location

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

用法

testCase.location

类型

parent​

添加于版本：v1.10 testCase.parent

此测试用例所属的套件。

用法

testCase.parent

类型

repeatEachIndex​

添加于版本：v1.10 testCase.repeatEachIndex

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

用法

testCase.repeatEachIndex

类型

results​

添加于版本：v1.10 testCase.results

此测试每次运行的结果。

用法

testCase.results

类型

retries​

添加于版本：v1.10 testCase.retries

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

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

用法

testCase.retries

类型

tags​

添加于版本：v1.42 testCase.tags

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

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

用法

testCase.tags

类型

timeout​

添加于版本：v1.10 testCase.timeout

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

用法

testCase.timeout

类型

title​

添加于版本：v1.10 testCase.title

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

用法

testCase.title

类型

type​

添加于版本：v1.44 testCase.type

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

用法

testCase.type

类型

  • "test"