Suite

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

• Root suite has a child suite for each TestProject.
  • Project suite #1. Has a child suite for each test file in the project.
    • File suite #1
      • TestCase #1
      • TestCase #2
      • Suite corresponding to a test.describe(title, callback) group
        • TestCase #1 in a group
        • TestCase #2 in a group
      • < more test cases ... >
    • File suite #2
    • < more file suites ... >
  • Project suite #2
  • < more project suites ... >

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

• suite.allTests()
• suite.titlePath()
• suite.location
• suite.suites
• suite.tests
• suite.title

suite.allTests()

• returns: <Array<TestCase>>#

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

suite.titlePath()

• returns: <Array<string>>#

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

suite.location

• type: <void|Location>

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

suite.suites

• type: <Array<Suite>>

Child suites. See Suite for the hierarchy of suites.

suite.tests

• type: <Array<TestCase>>

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(title, callback) groups are listed in the child suite.suites.

suite.title

• type: <string>

Suite title.

• Empty for root suite.
• Project name for project suite.
• File path for file suite.
• Title passed to test.describe(title, callback) for a group suite.