cypress-parallel

library0.15.0jsnpmunverified

A CLI tool that runs Cypress test specs in parallel on the same machine, reducing execution time by up to 40%. It shards spec files across a configurable number of threads, each running a Cypress command. Version 0.15.0 is current; releases are occasional with bug fixes and dependency updates. Differentiators: no external CI service required, supports weight files for balanced sharding, mono-repo support via reporterModulePath, and strict mode for validation. Peer dependency on cypress-multi-reporters (^2.0.5). Active maintenance with recent dependency security bumps.

testing devops

npm install cypress-parallel

github ↗package ↗

INSTALL

IMPORT

SIG · CYPRESS-PARALLEL

cypress-parallel

testingjavascriptv0.15.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

cli usage

✓ npx cypress-parallel -s cy:run -t 2 -d cypress/e2e

✗ npx cypress-parallel -s cypress run -t 2

The -s flag expects an npm script name, not a cypress command. Define a script in package.json first.

install

✓ npm i cypress-parallel

✗ npm install cypress-parallel --save-dev

Can be devDependency, but --save-dev is optional.

version

✓ const version = require('cypress-parallel/package.json').version

✗ import { version } from 'cypress-parallel'

Package has no main export; primarily used as a CLI tool. Importing directly may not work.

Install and run cypress-parallel with 2 threads, splitting specs from the cypress/e2e directory.

// In package.json: // "scripts": { // "cy:run": "cypress run", // "cy:parallel": "cypress-parallel -s cy:run -t 2 -d cypress/e2e" // } // Then run: // npm run cy:parallel // Alternative one-liner with npx: // npx cypress-parallel -s cy:run -t 2 -d cypress/e2e

cypress-parallel --version

Debug

Known issues

deprecatedThe 'colors' dependency was replaced with '@colors/colors' in v0.13.0 due to a security incident (CVE-2022-24785).

fix

Update to v0.13.0 or later.

affects: <0.13.0

gotchaUsing --strictMode (-m) with cypress-cucumber-preprocessor can cause errors. Disable strict mode if you use that preprocessor.

fix

Add -m false to the cypress-parallel command.

affects: >=0.8.4

gotchaThe --script (-s) option must be the name of an npm script (e.g., 'cy:run'), not a raw cypress command. Common mistake leads to 'command not found'.

fix

Define the cypress command in package.json scripts and pass that script name.

affects: >=0.1

gotchaIf using cypress-multi-reporters from a monorepo, the module may not be found. Use --reporterModulePath (-n) to specify the path.

fix

Add -n path/to/node_modules/cypress-multi-reporters

affects: >=0.9.0

gotchaThe number of threads (-t) should not exceed the number of spec files found. v0.12.0 added a check, but earlier versions may spin up unnecessary threads.

fix

Update to v0.12.0 or ensure -t <= spec count.

affects: <0.12.0

Errors

Common errors & fixes

Error: Cannot find module 'cypress-multi-reporters'

cypress-multi-reporters is not installed or not accessible in the working directory.

fix

Install cypress-multi-reporters: npm i cypress-multi-reporters

cypress-parallel: command not found

cypress-parallel is not installed or npx is used incorrectly.

fix

Use npx cypress-parallel or install globally: npm i -g cypress-parallel

Error: The script name 'cypress run' is not a valid npm script.

Passing cypress command directly to -s instead of an npm script name.

fix

Define a script in package.json, e.g., "cy:run": "cypress run" and use -s cy:run

Error: The number of threads (t) cannot be greater than the number of spec files found.

More threads than spec files; v0.12.0+ throws this error.

fix

Reduce -t to at most the number of spec files.

Upgrade

Version history

0.15.0latest on npm

Audit

Dependencies

cypress-multi-reportersoptionalPeer dependency, used for test reporting output

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/tnicola/cypress-parallel ↗

packagehttps://www.npmjs.com/package/cypress-parallel ↗