Allow choice of node-version with cypress/run job

[MikeMcC399]

What would you like?

Add a parameter node-version to the job cypress/run to allow selection of a Node.js release or describe how to set the Node.js version without needing an extra parameter.

Why is this needed?

cypress/run provides a convenient way to run Cypress tests. It is essential to be able to specify which version of Node.js is used. Many npm modules, which are configured together with Cypress tests, have exact restrictions on which Node.js versions they may be run with. The default executor defined by the Cypress CircleCI Orb may not work:

circleci-orb/src/executors/default.yml

Line 6 in d555dd3

default: "18.16.1"

Other

related to issues

• Docs for running with a specified node-version doesn't show how to change node version #468
• cypress/run has no executor param #429

According to the example, node-version is available for use with the command cypress/run-tests and is not mentioned for use with the job cypress/run:

circleci-orb/src/examples/node-version.yml

Lines 1 to 22 in d555dd3

	description: >
	Run Cypress tests using the cypress/default executor with a specified node version.
	usage:
	version: 2.1
	orbs:
	cypress: cypress-io/cypress@3
	jobs:
	run-cypress-in-specified-node-version:
	executor:
	name: cypress/default
	node-version: "20.6"
	steps:
	- cypress/install:
	package-manager: "yarn"
	- cypress/run-tests:
	start-command: "npm run start:dev"
	cypress-command: "npx cypress run"
	workflows:
	use-my-orb:
	jobs:
	- run-cypress-in-specified-node-version:
	name: Run Cypress in Node 20

[MikeMcC399]

• Resolved through PR feat: Allow choosing a Node version in the run job #484 in Orb release cypress-io/[email protected]