在前端开发中,测试环境是至关重要的。集成测试是为了保证所开发的应用功能的正确性和完整性。在传统的前端测试中,手动测试可能会很耗时且费力,因此许多开发者为了加快测试速度,选择了自动化测试。Cypress 就是一款自动化测试框架,让测试变得更加轻松和高效。那么,接下来我们将介绍如何搭建 Cypress 集成测试框架来解决测试环境问题。
安装 Cypress
要使用 Cypress 进行集成测试,需要安装 Cypress。可以通过以下命令进行安装:
npm install cypress --save-dev
当然,如果你是yarn用户,也可通过以下命令进行安装:
yarn add cypress --dev
创建 Cypress 配置文件
为了让 Cypress 正常使用,我们需要在项目根目录下创建配置文件 cypress.json
,并设置如下基本配置:
{ "baseUrl": "http://localhost:3000", "video": false, "ignoreTestFiles": [ "**/examples/*.spec.js" ] }
- baseUrl: 是你应用程序的 url,测试中的访问地址都是以它为基础的。
- video: 是否开启测试视频,设置为 false 表示关闭。
- ignoreTestFiles: 忽略哪些测试文件。以上面的配置为例,将忽略 examples 文件夹里的测试文件。
集成 Cypress
使用 Cypress 进行集成测试,需要在项目中引入 Cypress 测试代码。这里支持两种方式:
1.使用 Cypress CLI
在你的项目根目录下,执行以下命令进行初始化:
npx cypress open
这个命令将自动新建 cypress
目录,并在该目录中生成 Cypress 的初始化脚本和测试代码。
在这里,Cypress 在浏览器中打开了一个 UI 界面。如果界面闪了一下又退出了,可以尝试在应用程序中打开另一个终端来执行该命令。
Cypress 初始化之后,你将看到以下的目录结构:
cypress ├── fixtures // 包含静态资源和测试数据 ├── integration // 包含测试代码 ├── plugins // Cypress 插件目录 ├── support // 包含全局的辅助功能,如命令别名 ├── videos // 包含测试运行过程中的视频文件 ├── cypress.json // Cypress 配置
2.手动创建 Cypress 文件夹
手动创建以下目录结构:
cypress ├── fixtures // 包含静态资源和测试数据 ├── integration // 包含测试代码 ├── plugins // Cypress 插件目录 ├── support // 包含全局的辅助功能,如命令别名 ├── videos // 包含测试运行过程中的视频文件 ├── cypress.json // Cypress 配置
在该目录结构下,可以创建一个自己的测试代码库。比如,新建 login.spec.js
文件:
-- -------------------- ---- ------- ----------------- -- -- - --------- ------------ ---- ------- ------------ -- -- - ------------------ -------------------------------- ---------------------------------- --------------------------------- -------------------------- ------------- -- -------- -- ----- ---- --------- ------------ -- -- - ------------------ -------------------------------- ---------------------------------- --------------------------------- ---------------------------------- ----------- -------------------------- --------- -- --
其中,describe
和 it
都是 Cypress 自带的内置函数,一个组合了多个测试用例的集合,一个代表一个测试用例。我们通过 cy.visit()
进入登陆页面,并通过 cy.get()
查找页面元素,在输入用户名密码之后,点击登录按钮。最后用 cy.url()
验证是否跳转到了目标地址。
运行 Cypress 测试
在完成测试代码后,运行 Cypress 测试非常简单,只需运行以下命令:
npx cypress run
这将在命令行中开启 Cypress 测试运行器,并在测试结束时打印测试结果。如果测试异常退出,可以尝试增加 --headless
参数运行。
npx cypress run --headless
这也是为什么在开始运行 Cypress 命令时,ui 界面会自动退出的原因。
Cypress 还可直接从命令行中启动交互式 UI 界面,通过在命令行中执行 npx cypress open
来开启 UI 界面。接着,Cypress 就会在界面上显示出可供运行测试的文件夹和文件。
在 UI 界面中,可以选择要运行的测试文件,并通过单击它们来运行测试。在执行测试前,还可以通过修改配置和在脚本中添加断言和钩子来完善你的测试。
总结一下,使用 Cypress 进行集成测试可以显著提高测试效率,完成测试代码和测试运行器的搭建只需几步,而且上手也不难。Cypress 可以协助开发者更好地保证代码质量和项目可靠性,开发者也应该积极学习并运用到实际开发中。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/64bf99289e06631ab9c1fa4a