uirecorder遇到问题记录

一、原理流程图

测试脚本采用 BDD 的风格定义了测试用例，通过 Runner 执行（浏览器操作通过调用 WebDriver Service 实现），返回对应的回归测试结果（object），测试结果经过 Reporter 进行渲染，生成测试报告。

1.1 Runner
Runner 包括 mocha 、 macaca-mocha-parallel-tests （fork mocha-parallel-tests 优化的版本），其中跑单个测试用例使用 mocha ，并行跑多个测试用例则使用 macaca-mocha-parallel-tests 。Runner 的作用可以简单概括为以下三点：Pre-Loader（预加载功能）、Runner（执行器）、Reporter（报告器）。

Pre-Loader（预加载功能）：通过 describe/it 函数定义一组或单个的测试用例，通过 loader 处理，可转化成一个树状结构的 object
Runner（执行器）：object 可以通过 Runner 执行回归测试，输出测试结果（也是一个树状 object）
Reporter（报告器）：利用测试结果，生成简单格式的测试报告输出
1.2 Reporter
Mocha 自带的 Reporter 展示形式比较单一，难以满足我们的测试场景需求。UIRecorder 自主维护的两款报告器是 macaca-reporter 、 mochawesome-uirecorder ，uirecorder@3.0 版本以后统一使用 macaca-reporter ， mochawesome-uirecorder 已废弃。其中， macaca-reporter 的作用主要是利用 Runner 执行后返回的结果（object），自定义渲染模版，从链路树模式、脑图模式、全图模式和列表模式多维度直观呈现运行结果。

1.3 WebDriver Service
WebDriver 利用浏览器原生的API，封装了一层 WebDriver API，通过 http 协议可以直接操作浏览器页面的DOM节点元素，甚至操作浏览器本身（截屏，窗口大小，启动，关闭，安装插件，配置证书等）。且 Selenium 已得到各大主流浏览器厂商支持，可利用 WebDriver 服务进行多浏览器兼容性测试。

录制面板介绍：
属性开关：对于某些特殊场景，可以通过灵活的开启或关闭属性项，不同步骤选择不同的PATH生成策略，例如：某些控件不太适合用文本定位，就可以临时先关闭text属性项
属性值黑名单: 可以即时配置属性值黑名单，立即生效，用来解决随机属性值的问题，修改后记得按一下回车键，让变更立即生效，格式如下：/click_menu_\d+/
执行JS: 可以用来在浏览器端执行一些扩展功能，例如：document.title=123;
添加延迟：某些操作后，会发起异步请求，异步请求的完成时间不太确定时，可以通过添加延迟时间提升稳定性，时间单位是毫秒
脚本跳转：用来跳到新的URL，或者跳到另外一个脚本，一般情况下用来引用公共脚本，例如登录操作。

二、安装步骤

- 安装Nodejs（version>=12）

- 安装chrome+chromeDriver（两者版本一致）

chrome默认安装路径C:\Program Files (x86)\Google\Chrome\Application
注意：
1.chromeDriver版本需要和chrome浏览器版本一致或者大版本保持一致
2.解压后chromeDriver.exe包可以放到任何位置，建议和chrome浏览器安装路径保持一致
3.配置chromeDriver的环境变量Path路径

• 安装UIRecorder
  cnpm install uirecorder mocha macaca-reporter -g

• PC录制：

  1.创建项目目录，初始化工程 uirecorder init（需在git Bash下执行）
  2.开始录制 uirecorder start
  3.启动WebDriver服务
  cnpm install selenium-standalone@latest -g #安装selenium-standalone
  selenium-standalone install #安装selenium-standalone依赖
  selenium-standalone start #启动selenium-standalone
  mocha sample/test.spec.js #新开终端使用mocha回放（失败）
  uirecorder start sample/test.spec.js #使用uirecorder回放并继续录制（成功）
  4.运行测试用例/录制的脚本(需在CMD窗口下执行)（需要先启动webDriver服务 selenium-standalone start）
  运行所有脚本: source run.sh ( Linux|Mac ) 或 run.bat ( Windows ) （默认执行所有*.spec.js文件）或 npm run moduletest sample/*.js（指定执行所有js文件，可具体指定）
  运行单个脚本: source mocha sample/test.spec.js --reporter macaca-reporter ( Linux|Mac ) 或 mocha sample/test.spec.js --reporter macaca-reporter ( Windows )

三、安装遇到问题

1.安装nodejs版本应该大于12

2.macaca-mocha-parallel-tests只匹配mocha版本3，4，5，6

3.安装macaca-mocha-parallel-tests失败

设置全局安装就好了
npm install --save-dev mocha macaca-mocha-parallel-tests -g

4.mochawesome安装四失败，也是进行全局安装记好了

cnpm install -g --save-dev mochawesome