Documentation Home
This page describes a pre-release version of Jasmine (5.0.0-alpha.1). There may be additional changes, including breaking changes, before the final 5.0.0 release.
The current stable version of Jasmine is 5.4.

Class: ParallelRunner

ParallelRunner(options)

Configures, builds, and executes a Jasmine test suite in parallel.

Constructor

new ParallelRunner(options)

Parameters:
Name Type Description
options ParallelRunnerOptions | undefined
Example
const ParallelRunner = require('jasmine/parallel');
const runner = new ParallelRunner({numWorkers: 3});

Extends

Members

exitOnCompletion :boolean

Whether to cause the Node process to exit when the suite finishes executing.

Type:
  • boolean
Overrides:
Default Value:
  • true

Methods

addHelperFile(filePath)

Adds a helper file to the list that will be loaded when the suite is executed.

Parameters:
Name Type Description
filePath string

The path to the file to be loaded.

Inherited From:

addMatchingHelperFiles(patterns)

Adds files that match the specified patterns to the list of helper files.

Parameters:
Name Type Description
patterns Array.<string>

An array of helper file paths or globs that match helper files. Each path or glob will be evaluated relative to the spec directory.

Inherited From:

addMatchingSpecFiles(patterns)

Adds files that match the specified patterns to the list of spec files.

Parameters:
Name Type Description
patterns Array.<string>

An array of spec file paths or globs that match spec files. Each path or glob will be evaluated relative to the spec directory.

Inherited From:

addReporter(reporter)

Add a custom reporter to the Jasmine environment.

Parameters:
Name Type Description
reporter Reporter

The reporter to add

Overrides:
See:

addSpecFile(filePath)

Adds a spec file to the list that will be loaded when the suite is executed.

Parameters:
Name Type Description
filePath string

The path to the file to be loaded.

Inherited From:

alwaysListPendingSpecs(value)

Sets whether the console reporter should list pending specs even when there are failures.

Parameters:
Name Type Description
value boolean
Inherited From:

clearReporters()

Clears all registered reporters.

Overrides:

configureDefaultReporter(options)

Configures the default reporter that is installed if no other reporter is specified.

Parameters:
Name Type Description
options ConsoleReporterOptions
Inherited From:

(async) execute(filesopt, filterStringopt) → {Promise.<JasmineDoneInfo>}

Runs the test suite.

Note: Set exitOnCompletion to false if you intend to use the returned promise. Otherwise, the Node process will ordinarily exit before the promise is settled.

Parameters:
Name Type Attributes Description
files Array.<string> <optional>

Spec files to run instead of the previously configured set

filterString string <optional>

Regex used to filter specs. If specified, only specs with matching full names will be run.

Returns:

Promise that is resolved when the suite completes.

Type
Promise.<JasmineDoneInfo>

loadConfig(config)

Loads configuration from the specified object.

Parameters:
Name Type Description
config Configuration
Inherited From:

loadConfigFile(configFilePathopt)

Loads configuration from the specified file. The file can be a JSON file or any JS file that's loadable via require and provides a Jasmine config as its default export.

Parameters:
Name Type Attributes Default Description
configFilePath string <optional>
spec/support/jasmine.json
Inherited From:
Returns:

Promise

showColors(value)

Sets whether to show colors in the console reporter.

Parameters:
Name Type Description
value boolean

Whether to show colors

Inherited From: