Cypress--配置说明

不言

cypress

发布于：2020年3月24日

次浏览

前言

关于cypress的配置，其实很多都有默认配置，可以在cypress客户端看到。

打开cypress客户端选择项目目录，点击Settings-->Configuration。

配置介绍

以下内容转载于 https://www.cnblogs.com/leozhanggg/p/11011110.html

全局配置项

选项	默认	描述
`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`	等待响应完成的超时时间（以毫秒为单位）。包括命令：`cy.request()`，`cy.wait()`，`cy.fixture()，cy.screenshot()`，`cy.getCookie()`，`cy.getCookies()`，`cy.setCookie()`，`cy.clearCookie()`，`cy.clearCookies()`

文件路径配置项

选项	默认	描述
`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标志。

1
2
3

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_，否则将被忽略。且区分大小写。

1 2	export CYPRESS_VIEWPORT_WIDTH=800 export CYPRESS_VIEWPORT_HEIGHT=600

更新于：2025年6月17日

cypress

UI自动化

test

Cypress--生成Junit-allure报告

一.前言allure可能很多人都用过，对于生成测试报告来说比较方便。之前在python自动化里体验里一下，cypress作为js写的狂简，本身也有junit，也支持allure。二.配置生成...

Cypress--操作iframe页面

一.前言cypress对于iframe的操作比较蛋疼，虽然可以实现，但是丢失了很多特性，当我们操作iframe的时候，不会自动截图，在调试模式下也没法点选iframe内的元素。关于iframe...