将项目添加到cypress时，cypress.json会在项目中创建一个文件，此文件用于存储projectId，以及你提供的任何配置项。
可以通过以下提供的任何配置选项来修改赛普拉斯的默认行为。
全局配置项
|
选项 |
默认 |
描述 |
|---|---|---|
baseUrl
|
null
|
用作命令cy.visit()或cy.request()的前缀URL。 |
env
|
{}
|
设置任意环境变量。 |
ignoreTestFiles
|
*.hot-update.js
|
用于忽略测试文件的字符串或数组的glob模式，否则这些测试文件将显示在测试列表中。 |
numTestsKeptInMemory
|
50
|
快照和命令数据保存在内存中的测试数。 |
port
|
null
|
用于托管赛普拉斯的端口。 |
reporter
|
spec
|
该reporter中使用 cypress run。
|
reporterOptions
|
null
|
使用的reporter选项，支持的选项取决于reporter。 |
testFiles
|
**/*.*
|
要加载的测试文件的String glob模式。 |
watchForFileChanges
|
true
|
赛普拉斯是否检测并重新执行修改的测试文件。 |
超时配置项
|
选项 |
默认 |
描述 |
|---|---|---|
defaultCommandTimeout
|
4000
|
基于默认DOM命令的超时时间（以毫秒为单位） |
execTimeout
|
60000
|
基于cy.exec()命令的超时时间（以毫秒为单位）
|
taskTimeout
|
60000
|
基于cy.task()命令的超时时间（以毫秒为单位）
|
pageLoadTimeout
|
60000
|
等待页面加载完成的超时时间（以毫秒为单位）。包括命令： cy.visit()，cy.go()，cy.reload()
|
requestTimeout
|
5000
|
等待请求完成的超时时间（以毫秒为单位）。包括命令： cy.wait()
|
responseTimeout
|
30000
|
等待响应完成的超时时间（以毫秒为单位）。包括命令：
|
文件路径配置项
|
选项 |
默认 |
描述 |
|---|---|---|
fileServerFolder
|
cypress |
根项目文件夹 |
fixturesFolder
|
cypress/fixtures
|
包含混合文件的路径（通过 false禁用）
|
integrationFolder
|
cypress/integration
|
包含集成测试文件的路径 |
pluginsFile
|
cypress/plugins/index.js
|
插件文件的路径（通过 false禁用）
|
screenshotsFolder
|
cypress/screenshots
|
截图文件的路径，包含 cy.screenshot()命令 和 cypress run测试失败期间保存的屏幕截图。
|
supportFile
|
cypress/support/index.js
|
在加载测试文件之前加载文件的路径（通过 false禁用）
|
videosFolder
|
cypress/videos
|
视频文件的路径，用于保存 cypress run运行期间的视频。
|
截图配置项
|
选项 |
默认 |
描述 |
|---|---|---|
screenshotsFolder
|
cypress/screenshots
|
截图文件存放路径，包含 cy.screenshot()命令 和 cypress run测试失败期间保存的屏幕截图
|
trashAssetsBeforeRuns
|
true
|
在通过cypress run运行测试之前，赛普拉斯是否会清除creenshotsFolder和videosFolder。 |
录制配置项
| 选项 | 默认 | 描述 |
|---|---|---|
trashAssetsBeforeRuns |
true |
在通过cypress run运行测试之前，赛普拉斯是否会清除creenshotsFolder和videosFolder。 |
videoCompression |
32 |
视频压缩的质量设置。禁用压缩或0到51之间的值可以为false，值越低质量越好。 |
videosFolder |
cypress/videos |
视频文件的路径，用于保存cypress run运行期间的视频。 |
video |
true |
赛普拉斯是否捕捉通过cypress run运行测试的视频。 |
videoUploadOnPasses |
true |
当spec文件中的所有测试都通过，赛普拉斯是否会处理、压缩和上传视频到Dashboard。 |
浏览器配置项
| 选项 | 默认 | 描述 |
|---|---|---|
chromeWebSecurity |
true |
是否启用Chrome网页安全性中same-origin policy和insecure mixed content。 |
userAgent |
null |
浏览器在所有请求标头中发送的默认用户代理。 |
blacklistHosts |
null |
要阻止流量的字符串或主机阵列。 |
modifyObstructiveCode |
true |
赛普拉斯是否会在.js或.html文件中搜索和替换阻塞的JS代码。 |
视窗配置项
| 选项 | 默认 | 描述 |
|---|---|---|
viewportHeight |
660 |
测试视窗下应用程序的默认高度（以像素为单位，使用cy.viewport()命令覆盖）。 |
viewportWidth |
1000 |
测试视窗下应用程序的默认宽度（以像素为单位，使用cy.viewport()命令覆盖）。 |
动画配置项
| 选项 | 默认 | 描述 |
|---|---|---|
animationDistanceThreshold |
5 |
元素必须超过的指定像素距离才能被视为动画 |
waitForAnimations |
true |
是否在执行命令之前等待元素完成动画 |
命令行设置
当从命令行运行赛普拉斯时你可以传递一个 --config标志。
cypress open --config watchForFileChanges=false,waitForAnimations=false cypress run --config integrationFolder=tests,fixturesFolder=false cypress run --record --config viewportWidth=1280,viewportHeight=720
环境变量设置
您还可以使用环境变量来覆盖配置值。
这使您能够在不修改任何代码或构建脚本的情况下更改配置选项。默认情况下，与相应配置键匹配的任何环境变量都将覆盖该cypress.json值。
我们自动规范化键和值，赛普拉斯将剥去CYPRESS_。确保为环境变量添加前缀CYPRESS_，否则将被忽略。且区分大小写。
export CYPRESS_VIEWPORT_WIDTH=800 export CYPRESS_VIEWPORT_HEIGHT=600
初始配置：
Reference：https://docs.cypress.io/zh-cn/guides/references/configuration.html#blacklistHosts
原文地址：https://www.cnblogs.com/leozhanggg/p/11011110.html
时间： 2024-10-12 11:06:06