Cypress系列(44)- 命令行运行 Cypress
如果想从头学起Cypress,可以看下面的系列文章哦
https://www.cnblogs.com/poloyy/category/1768839.html
前言
前面也介绍过 Cypress 命令行,先来看看它的语法格式
cypress <command> [options]
- command:必选参数,可以是:open、run、install、verify、cache、help、version
- options:可选参数,不同 command 有不同的 options
cypress open 简介
简介
- 在交互模式下打开 Cypress 测试运行器(Test Runner)
- 在测试用例的运行过程中,测试用例的每一条命令,每一个操作都将显式地显示在测试运行器中
最简单的命令
进入项目根目录下
yarn run cypress open
通过 package.json 指定 scripts
"cypress:open": "cypress open"
yarn 运行
yarn cypress:open
npm 运行
npm run cypress:open
cypress open 详解
前言
- cypress open 运行时支持指定多个参数,指定的参数将自动应用于你通过测试运行器打开的项目
- 这些参数将应用于每一次测试运行,直到关闭测试运行器为止
- 指定的参数将会覆盖配置文件 cypress.json 中的相同参数
可选参数列表
--browser
默认情况下,Cypress 会自动查找你系统中可使用的浏览器,但是目前只有 Chrome 家族的浏览器才支持
cypress open --browser /usr/bin/chromium
--config
cypress open --config pageLoadTimeout=100000,watchForFileChanges=false
--config-file
默认情况下,所有的配置项都定义在 cypress.json 文件中
cypress open --config-file tests/cypress-config.json
--env
# 单个环境变量 cypress open --env host=api.dev.local # 多个环境变量 cypress open --env host=api.dev.local,port=4222 # 值为 json 字符串 cypress open --env flags='{"feature-a":true,"feature-b":false}'
--global
允许在多个嵌套项目中共享同一个安装好的 Cypress 版本
cypress open --global
--port
cypress open --port 8080
--project
用来指定待运行的项目,如果你的项目包含多个子项目,可以用此参数来运行指定的子项目(包括加载对应项目的配置)
cypress open --project ./some/nested/folder
Cypress run 详解
作用
默认情况下,Cypress 会将 electron 作为无头浏览器运行完所有的测试用例
可选参数列表
--browser
只要系统上可以检测到,browser 参数可以被设置为 chrome ,canary,chromium,electron,Cypress 会试图自动找到已经装好的浏览器
cypress run --browser chrome
--config、--config-file、--env、--port、--help、--project
和上面 cypress open 用法一致
--spec
- 指定运行哪些测试文件夹/文件
- 如果不指定测试文件夹,Cypress 将为你自动运行所有存在 Integration 文件夹下的测试用例
栗子
运行某个单独的测试文件而不是所有的测试用例
cypress run --spec "cypress/integration/examples/actions.spec.js"
运行*号匹配到的文件目录(注意:推荐使用双星号**)
cypress run --spec "cypress/integration/login/**/*"
运行指定多个测试文件
cypress run --spec "cypress/integration/examples/actions.spec.js,cypress/integration/examples/files.spec.js"
--record --key
在测试运行时录制视频
cypress run --record --key
如果在 cypress.json 中设置了环境变量 CYPRESS_RECORD_KEY,你可以忽略 --key 参数。
--ci-build-id
用于分组运行或者并行运行,它通过指定一个唯一的标识符来实现,必须配合参数 --group 或 --parallel 才能使用
cypress run --ci-build-id BUILD_NUMBER
通常这个标识符被设置为持续集成环境的环境变量
--group
在一次运行中,把符合条件的测试用例分组展示
cypress run --group admin-tests --spec 'cypress/integration/admin/**/*'
--parallel
在多台机器上并行运行测试文件(后面文章再展开详解)
cypress run --record --parallel --group e2e-staging-specs
结合 --group 使用
--headed
cypress run --headed chrome
默认是无头模式,加上就是使用 chrome 浏览器运行
--no-exit
cypress run --headed --no-exit
结合 --headed 来指定测试运行时显示及在运行后查看命令日志
--reporter、--reporter-options
- 用来指定 Mocha 的 reporter
- 在测试报告文章中有详细讲解过,https://www.cnblogs.com/poloyy/p/13030898.html
cypress verify 详解
作用
验证 Cypress 安装正确并可用
实际
C:\Users\user\Desktop\py\MyCypress>yarn run cypress verify yarn run v1.22.4 $ C:\Users\user\Desktop\py\MyCypress\node_modules\.bin\cypress verify √ Verified Cypress! C:\Users\user\AppData\Local\Cypress\Cache\5.1.0\Cypress Done in 3.99s.
cypress verison 详解
查看版本信息
C:\Users\user\Desktop\py\MyCypress>yarn run cypress version yarn run v1.22.4 $ C:\Users\user\Desktop\py\MyCypress\node_modules\.bin\cypress version Cypress package version: 5.1.0 Cypress binary version: 5.1.0 Done in 0.69s.