TestCase
Added in: v1.10TestCase corresponds to every test.(call)() call in a test file. When a single test.(call)() is running in multiple projects or repeated multiple times, it will have multiple TestCase objects in corresponding projects' suites.
Methods
testCase.ok()
Added in: v1.10Whether the test is considered running fine. Non-ok tests fail the test run with non-zero exit code.
Returns
boolean
testCase.outcome()
Added in: v1.10Testing outcome for this test. Note that outcome is not the same as testResult.status:
- Test that is expected to fail and actually fails is
'expected'. - Test that passes on a second retry is
'flaky'.
Returns
"skipped" | "expected" | "unexpected" | "flaky"
testCase.titlePath()
Added in: v1.10Returns a list of titles from the root down to this test.
Returns
Array<string>
Properties
testCase.annotations
Added in: v1.10testResult.annotations of the last test run.
Type
Array<Object>
testCase.expectedStatus
Added in: v1.10Expected test status.
- Tests marked as
test.skip()ortest.fixme()are expected to be'skipped'. - Tests marked as
test.fail()are expected to be'failed'. - Other tests are expected to be
'passed'.
See also testResult.status for the actual status.
Type
"passed" | "failed" | "timedOut" | "skipped" | "interrupted"
testCase.id
Added in: v1.25A test ID that is computed based on the test file name, test title and project name. The ID is unique within Playwright session.
Type
string
testCase.location
Added in: v1.10Location in the source where the test is defined.
Type
Location
testCase.parent
Added in: v1.10Suite this test case belongs to.
Type
Suite
testCase.repeatEachIndex
Added in: v1.10Contains the repeat index when running in "repeat each" mode. This mode is enabled by passing --repeat-each to the command line.
Type
int
testCase.results
Added in: v1.10Results for each run of this test.
Type
Array<TestResult>
testCase.retries
Added in: v1.10The maximum number of retries given to this test in the configuration. With conditional retries, this is updated after each failed attempt to the number of retries that applies to that failure.
Learn more about test retries.
Type
int
testCase.tags
Added in: v1.42The list of tags defined on the test or suite via test.(call)() or test.describe(), as well as @-tokens extracted from test and suite titles.
Learn more about test tags.
Type
Array<string>
testCase.timeout
Added in: v1.10The timeout given to the test. Affected by testConfig.timeout, testProject.timeout, test.setTimeout(), test.slow() and testInfo.setTimeout().
Type
float
testCase.title
Added in: v1.10Test title as passed to the test.(call)() call.
Type
string
testCase.type
Added in: v1.44Returns "test". Useful for detecting test cases in suite.entries().
Type
"test"