interface RunOptions
Properties #
#concurrency: number
| boolean
| undefined 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.
An array containing the list of files to run. If omitted, files are run according to the test runner execution model.
Configures the test runner to exit the process once all known tests have finished executing even if the event loop would otherwise remain active.
#globPatterns: readonly string[] | undefined 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.
#inspectPort: number
| (() => number)
| undefined 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.
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.
If truthy, the test context will only run tests that have the only option set
#setup: ((reporter: TestsStream) => void | Promise<void>) | undefined A function that accepts the TestsStream instance and can be used to setup listeners before any tests are run.
An array of CLI flags to pass to the node executable when
spawning the subprocesses. This option has no effect when isolation is 'none'.
An array of CLI flags to pass to each test file when spawning the
subprocesses. This option has no effect when isolation is 'none'.
#testNamePatterns: string
| RegExp
| ReadonlyArray<string | RegExp>
| undefined If provided, only run tests whose name matches the provided pattern. Strings are interpreted as JavaScript regular expressions.
#testSkipPatterns: string
| RegExp
| ReadonlyArray<string | RegExp>
| undefined 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.
The number of milliseconds after which the test execution will fail. If unspecified, subtests inherit this value from their parent.
enable code coverage collection.
#coverageExcludeGlobs: string
| readonly string[]
| undefined 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.
#coverageIncludeGlobs: string
| readonly string[]
| undefined 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.
#lineCoverage: number | undefined Require a minimum percent of covered lines. If code
coverage does not reach the threshold specified, the process will exit with code 1.
#branchCoverage: number | undefined Require a minimum percent of covered branches. If code
coverage does not reach the threshold specified, the process will exit with code 1.
#functionCoverage: number | undefined Require a minimum percent of covered functions. If code
coverage does not reach the threshold specified, the process will exit with code 1.