Skip to content

Produce action warning if parameters incompatible with command parameter are used #1439

@MikeMcC399

Description

@MikeMcC399

What would you like?

If the action is called with a command parameter and other incompatible parameters are also defined, then the action should produce a warning.

Why is this needed?

The command parameter executes a tool command using the GitHub @actions/exec action. This does not call the Cypress Module API, so any parameters that can only be consumed this way are ignored.

The following input parameters are only effective if Cypress Module API is called:

Action Parameter Description
auto-cancel-after-failures Set the failed test threshold for auto cancellation or disable auto cancellation for Cloud recording
browser Select browser that Cypress runs in. A filesystem path to a browser is also allowed.
component Run component tests
config Specify configuration
config-file Specify configuration file
group Group recorded tests together under a single run for Cloud recording
headed Display the browser instead of running headlessly
parallel Run recorded specs in parallel across multiple machines for Cloud recording
project Path to a specific project
quiet Reduce output to stdout
record Record the test run to Cypress Cloud
spec Specify the spec files to run
tag Identify a run with a tag or tags
publish-summary Publish a job summary
summary-title Title for job summary

Additionally, the command-prefix is not used if the command parameter is defined. This is a consequence of the action logic which checks and executes a defined command parameter before checking for the presence of a command-prefix parameter.

Action Parameter Description
command-prefix converts the Module API call into a CLI call with prefix.

Users are sometimes misled because there is no warning. Although the README > Custom test command section includes a corresponding caution note, some users overlook this.

Other

The README documentation should be improved to assist users who have previously been calling Cypress with CLI commands, so that it is clear how to migrate to using the Cypress GitHub Action.

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions