Cypress系列72- 详解 Module API

如果想从头学起Cypress，可以看下面的系列文章哦

https://www.cnblogs.com/poloyy/category/1768839.html

 

前言

• 前面介绍 Cypress 如何通过命令行运行，就是采用 cypress run 或 cypress open 命令，但这不是 Cypress 唯一的运行方式
• Cypress 还允许你将它视为一个 Node Module 来运行，然后通过Node.js运行Cypress，这种方式可以更加灵活地定制测试行为
• 当想在运行后直接访问测试结果时，此功能很有用

 

如何有用

• 挑选测试用例运行
• 整合所有测试用例，提供一份完整HTML格式的测试报告
• 重新运行单个失败的 spec 文件
• 发送有关测试失败的通知，包括附带的屏幕截图
• 启动其他构建行为或脚本

 

重点

模块 API支持两个命令： cypress.run() 和 cypress.open() 

 

cypress.run() 命令详解

栗子

代码

// 导入 cypress 模块
const cypress = require('cypress')

 执行 run 命令
cypress.run({
    spec: './cypress/integration/00_examples/actions.spec.js'
})
.then((results) => {
     打印结果
    console.log(results)
})
.catch((err) => 抓取错误信息并打印
    console.error(err)
})

 

运行命令

可以在 cmd 窗口或 npm 脚本中运行下列命令

node 1_run.js

 

运行结果

最终运行的是 actions.spec.js 这个测试用例文件

 

参数列表

和 cypress run 命令行运行的参数一样

 

命令返回结果

cypress.run() 返回一个Promise对象，该 Promise 包含测试结果对象（类似 json 格式的数据），典型的运行可能会返回以下内容：

{
  startedTestsAt: '2020-10-23T06:22:53.210Z',endedTestsAt: '2020-10-23T06:23:23.342Z'100'cypress/reporters/custom_reporter.js'nulltrue
    }
  ],browserPath: '''85.0.4183.121''10.0.18363'10000'bar''test'
    },configFile: 'C:\\Users\\user\\Desktop\\py\\MyCypress\\cypress.json''http://localhost:7077/''dev''MyCypress'false'wj65e'5'C:\\Users\\user\\Desktop\\py\\MyCypress\\cypress\\component''C:\\Users\\user\\Desktop\\py\\MyCypress' },fixturesFolder: 'C:\\Users\\user\\Desktop\\py\\MyCypress\\cypress\\fixtures''*.hot-update.js''C:\\Users\\user\\Desktop\\py\\MyCypress\\cypress\\integration''__cypress'0'C:\\Users\\user\\Desktop\\py\\MyCypress\\cypress\\plugins\\index.js''/__cypress/reporter'30000'C:\\Users\\user\\Desktop\\py\\MyCypress\\cypress\\screenshots''__socket.io'60000'C:\\Users\\user\\Desktop\\py\\MyCypress\\cypress\\videos'660'/xhrs/''C:\\Users\\user\\Desktop\\py\\MyCypress\\cypress''C:\\Users\\user\\Desktop\\py\\MyCypress\\cypress\\support''C:\\Users\\user\\Desktop\\py\\MyCypress\\cypress\\integration\\examples''http://localhost:59756''http://localhost:59756/__cypress/reporter'
  }
}

 

cypress.open() 命令详解

栗子

代码

 执行 open 命令
cypress.open({
     命令参数列表
    config: {
        baseUrl: 'http://localhost:8080''/products'
node 2_open.js

 

运行结果

在 2_open.js 设置的 config 或 env 会当成 CLI 模式下设置的

 

参数列表

和 cypress open 命令行运行的参数一样

 

待更新

完整的 module api 项目

 

原文地址：https://www.cnblogs.com/poloyy