cf-auto

使用

1. 安装

npm install -g cf-auto

1. 项目根目录下添加配置文件: auto.json

{
  // 测试脚本所在目录
  "auto": "auto",
  // 项目在本地运行时所在的目录
  "dist": "dist",
  // 自动测试运行时的临时目录
  "temp": "auto_temp",
  // 自动测试服务运行的端口
  "serverPort": "12345",
  // 自动测试监听状态下的自动更新监听端口
  "liveReloadPort": "12346",
  // 测试目标地址，花括号中的参数将会被taskList的项目中的属性替代
  "target": "http://localhost:4400/?{{sid}}&auto_path={{path}}",
  // 任务列表，可以配置多个
  "taskList": [
    {
      // 任务要使用的问卷id
      "sid": "9f7026db-f762-4709-a1ed-35c689625164",
      // 任务测试脚本坐在路径，起始于auto参数指定的文件夹
      "path": "basic/index"
    }
  ]
}

测试启动时将读取配置文件，对每个任务进行单独的测试，并报告测试结果。

1. 编写测试脚本
   • 测试脚本使用es6模块化编写
     • src/assist下面的两本文件：test.js和tool.js将会被注入到测试网站中assist目录下， 测试脚本可以直接import这两本中export过的变量
     • 在测试项目中生成到temp目录中的结构将如下：

     temp
     |   assist // 这个就是src/assist转移过去的,
     |          // 里面的文件将会以模块方式注入到被测试网站中
     |------test.js
     |------tool.js
     |   tasks  // 这个就是auto目录中的测试脚本转移到了这里
     |   chai.js // 测试断言库，将会注入到被测试网站中
     |   index.html // 启动测试的页面，将会以iframe的方式打开每个测试任务
     |   index.js // 启动页面的依赖脚本
     

   • 测试脚本中可以从assist/test中引入tester开始测试,引用路径关系以生成后的temp目录为准

     import {tester, deepEqual} from '../assist/test'
     // 调用init先配置一下问卷id和问卷标题，
     // 这两个属性可以从被测试网站的暴露在全局中的对象中找到
     // 多次init的话将以最后一次为准
     tester.init({sid: 'xxxx', title:'xxxx'})
     // 链式调用开始测试
     // assert是chai单元库的的assert风格断言对象
     // deepEqual是自定义的一个深对比断言方法，相对于assert.deepEqual来说
     // 前者会具体深入报考那一层那个属性没有断言成功，利于观察，后者则不会
     .test('测试1',(assert) => {
         assert.equal(1, 2, '1===2')
         deepEqual({a:{a:1}}, {a:{b:1}}, assert, 'deep equal');
     })
     // 测试可以返回一个promise,如果返回了promise
     // 则后续的测试将会等待promise被resolve之后才执行
     // 这种方式在模拟人为操作的时候，
     // 或者测试间状态互相依赖的场合非常有用
     .test('测试2',(assert) => {
         assert.equal(1, 2, '1===2')
         return new Promise(resolve => {
             setTimeout(resolve, 2000)
         })
     })
     // 这个测试将等到'测试2'执行完两秒后才被执行
     .test('测试3',(assert) => {
         assert.equal('1', '1', '1===1')
     })
     // 暂时跳过的测试
     .skip('测试4',(assert) => {
         // 这个测试将会被跳过
     })
     // 将要做的测试
     .todo('测试5',(assert) => {
         // 这个测试也会被跳过
     })
     
     

2. 写好了测试脚本后，运行cf-auto即可开始跑起测试
   • 将通过webdriver启动chrome进行测试，当测试完毕后关闭浏览器并在控制台中会报告结果。
   • 如果加了--watch参数，则会运行完测试后浏览器不会被关闭，会一直处于等待状态，并监听 项目业务代码变化和测试脚本变化，当发生任何变化的时候将重新运行测试，浏览器测试页面中 也会显示测试结果。
   • 如果接了--display参数，则测试页面中将显示每个测试iframe中的真实运行情况