TestOptions.baseURL configuration
The baseURL option sets a base URL to use in actions like await page.goto('/'). It is commonly set to a local development server URL such as 'http://localhost:3000'.
Playwright · Test runner API · all subjects
test-api
157 notes in this subject, read out of this brain and free to use. This is page 3 of 3.
TestOptions.browserName default value
The browserName option specifies which browser runs the tests. Type is BrowserName with values 'chromium', 'firefox', or 'webkit'. Defaults to 'chromium'.
TestOptions.actionTimeout default
The actionTimeout option sets the default timeout for each Playwright action in milliseconds. Type is int. Defaults to 0 (no timeout).
TestOptions.bypassCSP configuration
The bypassCSP option bypasses Content Security Policy when set to true.
TestOptions.channel configuration
The channel option specifies a browser channel to use, such as 'msedge' for Microsoft Edge.
TestOptions.clientCertificates structure and usage
The clientCertificates option accepts an array of certificate configurations. Each certificate object contains: origin (string), certPath (string), keyPath (string), and passphrase (string).
TestOptions.colorScheme configuration
The colorScheme option sets the color scheme emulation, such as 'dark'.
TestOptions.connectOptions structure
The connectOptions option has type void | Object with the following properties: wsEndpoint (string, required), headers (optional Object of string to string key-value pairs), timeout (optional int in milliseconds), and exposeNetwork (optional string). When connect options are specified, the default browser, context, and page fixtures use the remote browser instead of launching locally, and launch options like headless or channel are ignored.
TestOptions.contextOptions configuration
The contextOptions option takes an Object of options passed to Browser.newContext. Specific options like viewport take priority over contextOptions.
TestOptions.contrast configuration
The contrast option controls contrast emulation, such as 'more'.
TestOptions.deviceScaleFactor configuration
The deviceScaleFactor option sets the device scale factor for emulation.
TestOptions.extraHTTPHeaders configuration
The extraHTTPHeaders option sets custom HTTP headers to be sent with all requests. It accepts an object with header names as keys and header values as values.
TestResult.stderr property
TestResult.stderr is an array of strings or Buffers containing anything written to standard error during the test run. Available since v1.10.
TestResult.workerIndex property
TestResult.workerIndex is an integer representing the index of the worker where the test was run. If the test was not run a single time, for example when the user interrupted testing, the only result will have a workerIndex equal to -1. Available since v1.10.
TestResult.parallelIndex property
TestResult.parallelIndex is an integer representing the index of the worker between 0 and workers - 1. It is guaranteed that workers running at the same time have a different parallelIndex. Available since v1.30.
TestResult class overview
TestResult represents the result of a single TestCase run. It has been available since v1.10.
TestResult.attachments property
TestResult.attachments is an array of objects representing files or buffers attached during test execution through TestInfo.attachments. Each attachment object has: name (string, required), contentType (string, required), path (optional string for filesystem path to attached file), and body (optional Buffer for attachment body used instead of a file). Available since v1.10.
TestResult.annotations property
TestResult.annotations is an array of objects representing annotations applicable to the current test, available since v1.52. Each annotation has: type (string, required, for example 'skip' or 'fail'), description (optional string), and location (optional Location in source where annotation is added). Annotations include those defined on the test or suite, implicitly added by Test.skip/fixme/fail methods, and appended to TestInfo.annotations during execution.
TestResult.duration property
TestResult.duration is a float representing running time in milliseconds. Available since v1.10.
TestResult.error property
TestResult.error is the first error thrown during test execution, if any. It is equal to the first element in TestResult.errors. The type is optional TestError. Available since v1.10.
TestResult.stdout property
TestResult.stdout is an array of strings or Buffers containing anything written to standard output during the test run. Available since v1.10.
TestResult.steps property
TestResult.steps is an array of TestStep objects representing the list of steps inside the test run. Available since v1.10.
TestResult.errors property
TestResult.errors is an array of TestError objects containing all errors thrown during test execution. Available since v1.10.
TestResult.retry property
TestResult.retry is an integer representing the sequential number assigned to each retry attempt when a test is retried multiple times. Available since v1.10.
TestResult.startTime property
TestResult.startTime is a Date representing the start time of the particular test run. Available since v1.10.
TestResult.status property
TestResult.status is the status of the test result, with type TestStatus. Possible values are 'passed', 'failed', 'timedOut', 'skipped', or 'interrupted'. Available since v1.10.
TestStep.location property
The location property of TestStep is an optional Location object indicating where the step is defined in the source code.
TestStep.attachments property
The attachments property of TestStep is an array of objects representing files or buffers attached in the step execution through TestInfo.attach. Each attachment object has a required 'name' field (string), a required 'contentType' field (string describing the content type like 'application/json' or 'image/png'), an optional 'path' field (string for filesystem path to the attached file), and an optional 'body' field (Buffer used instead of a file).
TestStep.annotations property
The annotations property of TestStep is an array of objects containing the list of annotations applicable to the current test step. Each annotation object has a 'type' field (required, string, for example 'skip'), an optional 'description' field (string), and an optional 'location' field (Location object indicating where the annotation is added in the source).
TestStep.duration property
The duration property of TestStep is a float representing the running time of the step in milliseconds.
TestStep.category property
The category property of TestStep is a string that differentiates steps with different origin and verbosity. Built-in categories are: 'expect' for expect calls, 'fixture' for fixtures setup and teardown, 'hook' for hooks initialization and teardown, 'pw:api' for Playwright API calls, 'test.step' for test.step API calls, and 'test.attach' for testInfo.attach API calls.
TestStep.title property
The title property of TestStep is a string containing a user-friendly test step title.
TestStep.steps property
The steps property of TestStep is an array of TestStep objects representing a list of steps inside this step.
TestStep.startTime property
The startTime property of TestStep is a Date object representing the start time of the particular test step.
TestStep.parent property
The parent property of TestStep is an optional reference to the parent TestStep, if this step is nested within another step.
TestStep.error property
The error property of TestStep is an optional TestError object containing any error thrown during the step execution.
TestStep.titlePath method
The titlePath method of TestStep returns an array of strings containing a list of step titles from the root step down to the current step.