RunOptions

sealed external interface RunOptions(source)

Properties

Link copied to clipboard
abstract var argv: <Error class: unknown class><String>?

An array of CLI flags to pass to each test file when spawning the subprocesses. This option has no effect when isolation is 'none'.

Link copied to clipboard
abstract var branchCoverage: Double?

Require a minimum percent of covered branches. If code coverage does not reach the threshold specified, the process will exit with code 1.

Link copied to clipboard
abstract var concurrency: Any?

If a number is provided, then that many test processes would run in parallel, where each process corresponds to one test file. If true, it would run os.availableParallelism() - 1 test files in parallel. If false, it would only run one test file at a time.

Link copied to clipboard
abstract var coverage: Boolean?

enable code coverage collection.

Link copied to clipboard
abstract var coverageExcludeGlobs: Any?

Excludes specific files from code coverage using a glob pattern, which can match both absolute and relative file paths. This property is only applicable when coverage was set to true. If both coverageExcludeGlobs and coverageIncludeGlobs are provided, files must meet both criteria to be included in the coverage report.

Link copied to clipboard
abstract var coverageIncludeGlobs: Any?

Includes specific files in code coverage using a glob pattern, which can match both absolute and relative file paths. This property is only applicable when coverage was set to true. If both coverageExcludeGlobs and coverageIncludeGlobs are provided, files must meet both criteria to be included in the coverage report.

Link copied to clipboard
abstract var execArgv: <Error class: unknown class><String>?

An array of CLI flags to pass to the node executable when spawning the subprocesses. This option has no effect when isolation is 'none'.

Link copied to clipboard
abstract var files: <Error class: unknown class><String>?

An array containing the list of files to run. If omitted, files are run according to the test runner execution model.

Link copied to clipboard
abstract var forceExit: Boolean?

Configures the test runner to exit the process once all known tests have finished executing even if the event loop would otherwise remain active.

Link copied to clipboard
abstract var functionCoverage: Double?

Require a minimum percent of covered functions. If code coverage does not reach the threshold specified, the process will exit with code 1.

Link copied to clipboard
abstract var globPatterns: <Error class: unknown class><String>?

An array containing the list of glob patterns to match test files. This option cannot be used together with files. If omitted, files are run according to the test runner execution model.

Link copied to clipboard
abstract var inspectPort: Any?

Sets inspector port of test child process. This can be a number, or a function that takes no arguments and returns a number. If a nullish value is provided, each process gets its own port, incremented from the primary's process.debugPort. This option is ignored if the isolation option is set to 'none' as no child processes are spawned.

Link copied to clipboard

Configures the type of test isolation. If set to 'process', each test file is run in a separate child process. If set to 'none', all test files run in the current process.

Link copied to clipboard
abstract var lineCoverage: Double?

Require a minimum percent of covered lines. If code coverage does not reach the threshold specified, the process will exit with code 1.

Link copied to clipboard
abstract var only: Boolean?

If truthy, the test context will only run tests that have the only option set

Link copied to clipboard
abstract var setup: (reporter: TestsStream) -> <Error class: unknown class><<Error class: unknown class>>?

A function that accepts the TestsStream instance and can be used to setup listeners before any tests are run.

Link copied to clipboard
abstract var shard: TestShard?

Running tests in a specific shard.

Link copied to clipboard
abstract var signal: <Error class: unknown class>?

Allows aborting an in-progress test execution.

Link copied to clipboard
abstract var testNamePatterns: Any?

If provided, only run tests whose name matches the provided pattern. Strings are interpreted as JavaScript regular expressions.

Link copied to clipboard
abstract var testSkipPatterns: Any?

A String, RegExp or a RegExp Array, that can be used to exclude running tests whose name matches the provided pattern. Test name patterns are interpreted as JavaScript regular expressions. For each test that is executed, any corresponding test hooks, such as beforeEach(), are also run.

Link copied to clipboard
abstract var timeout: Double?

The number of milliseconds after which the test execution will fail. If unspecified, subtests inherit this value from their parent.

Link copied to clipboard
abstract var watch: Boolean?

Whether to run in watch mode or not.