前言

非 GUI 模式下命令行运行 cypress，需知道有哪些参数可以使用。

查看命令行参数

输入 -h 查看命令行参数

cypress run -h

Runs Cypress tests from the CLI without the GUI

Options:
  -b, --browser <browser-name-or-path>       runs Cypress in the browser with the given name. if a filesystem path is
                                             supplied, Cypress will attempt to use the browser at that path.
  --ci-build-id <id>                         the unique identifier for a run on your CI provider. typically a
                                             "BUILD_ID" env var. this value is automatically detected for most CI
                                             providers
  -c, --config <config>                      sets configuration values. separate multiple values with a comma.
                                             overrides any value in cypress.json.
  -C, --config-file <config-file>            path to JSON file where configuration values are set. defaults to
                                             "cypress.json". pass "false" to disable.
  -e, --env <env>                            sets environment variables. separate multiple values with a comma.
                                             overrides any value in cypress.json or cypress.env.json
  --group <name>                             a named group for recorded runs in the Cypress Dashboard
  -k, --key <record-key>                     your secret Record Key. you can omit this if you set a CYPRESS_RECORD_KEY
                                             environment variable.
  --headed                                   displays the browser instead of running headlessly (defaults to true for
                                             Firefox and Chromium-family browsers)
  --headless                                 hide the browser instead of running headed (defaults to true for Electron)
  --no-exit                                  keep the browser open after tests finish
  --parallel                                 enables concurrent runs and automatic load balancing of specs across
                                             multiple machines or processes
  -p, --port <port>                          runs Cypress on a specific port. overrides any value in cypress.json.
  -P, --project <project-path>               path to the project
  --record [bool]                            records the run. sends test results, screenshots and videos to your
                                             Cypress Dashboard.
  -r, --reporter <reporter>                  runs a specific mocha reporter. pass a path to use a custom reporter.
                                             defaults to "spec"
  -o, --reporter-options <reporter-options>  options for the mocha reporter. defaults to "null"
  -s, --spec <spec>                          runs specific spec file(s). defaults to "all"
  -t, --tag <tag>                            named tag(s) for recorded runs in the Cypress Dashboard
  --dev                                      runs cypress in development and bypasses binary check
  -h, --help                                 output usage information

参数功能说明

参数使用语法

--headed

默认情况下，Cypress 会将 Electron 作为无头浏览器运行完你所有的测试用例。
加上--headed参数将强制显式运行 Electron 浏览器

cypress run --headed

--no-exit

使用命令行运行完用例后，会自动关闭 cypress 运行器页面，想在运行完毕测试用例后不关闭Cypress运行器，请使用--no-exit.

cypress run --headed --no-exit

--port

每次启动 cypress 运行器界面，执行用例的时候，会随机分配一个端口运行。
可以使用 --port 指定运行的端口

cypress run --port 8080

--project

默认情况下，Cypress 会在 package.json 所在的目录查找 cypress.json 文件。

如果你有多个运行的项目，你可以在每个项目下写个cypress.json 文件，当然你也可以指明 Cypress 在不同的位置运行。

cypress run --project ./project/path/folder

关于多个项目的使用，可以参考这个项目地址https://github.com/cypress-io/cypress-test-nested-projects

其他更多命令行参数，参考文档https://docs.cypress.io/zh-cn/guides/guides/command-line.html#cypress-run

Cypress web自动化23-cypress run 命令行参数详解