uirecorder
Version:
Tool for record ui test case
168 lines (100 loc) • 5.39 kB
Markdown
# UI Recorder
---
[](https://www.npmjs.com/package/uirecorder)
[](https://www.npmjs.com/package/uirecorder)
[](https://www.npmjs.com/package/uirecorder)
[](https://www.npmjs.com/package/uirecorder)
[](https://testerhome.com/github_statistics)
UI Recorder 是一款面向多端的 UI 自动化录制工具，类似于[Selenium IDE](http://docs.seleniumhq.org/projects/ide/) 但比Selenium IDE 更加强大!
UI Recorder 非常简单易用，零成本解决测试回归问题。
1. 官方网站: [http://uirecorder.com/](http://uirecorder.com/)
2. 语言切换: [English](https://github.com/alibaba/uirecorder/blob/master/README.md), [中文](https://github.com/alibaba/uirecorder/blob/master/README_zh-cn.md)
3. 变更日志: [CHANGE](https://github.com/alibaba/uirecorder/blob/master/CHANGE.md)
4. 视频教程：[PC中文教程](http://v.youku.com/v_show/id_XMTY4NTk5NjI4MA==.html)
5. 钉钉交流群：30684524(加入验证：UIRecorder录制)，下载钉钉：[https://www.dingtalk.com/](https://www.dingtalk.com/)
6. 最新中文手册：[语雀文档](https://www.yuque.com/artist/uirecorder)、[Github Page](https://alibaba.github.io/uirecorder/build/#/artist/uirecorder/hbqzpl)
# 功能
1. 支持所有用户行为: 键盘事件, 鼠标事件, alert, 文件上传, 拖放, svg, shadow dom
2. 全平台支持，移动端 Android, iOS 录制, 基于 [Macaca](https://macacajs.github.io) 实现
3. 无干扰录制: 和正常测试无任何区别，无需任何交互
4. 录制用例存储在本地
5. 支持丰富的断言类型: val,text,displayed,enabled,selected,attr,css,url,title,cookie,localStorage,sessionStorage
6. 支持图片对比
7. 支持强大的变量字符串
8. 支持公共测试用例: 允许用例中动态调用另外一个
9. 支持并发测试
10. 支持多国语言: 英文, 简体中文, 繁体中文
11. 支持单步截图
12. 支持HTML报告和JUnit报告
13. 全系统支持: Windows, Mac, Linux
14. 基于Nodejs的测试用例: [jWebDriver](http://jwebdriver.com/)
# 软件截图
# 视频演示
# 快速开始
## 安装
1. 安装 NodeJs (版本号 >= v7.x)
> [https://nodejs.org/](https://nodejs.org/)
> `sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}` (Mac, Linux)
2. 安装 chrome
> [https://www.google.com/chrome/](https://www.google.com/chrome/)
3. 安装 UI Recorder
> `npm install uirecorder mocha -g`
## PC录制
1. 初始化测试工程
> 创建新文件夹
> `uirecorder init`
2. 开始录制测试用例
> 修改hosts文件
> `uirecorder sample/test.spec.js`
3. 启动WebDriver服务器
4. 运行测试用例
> 运行所有脚本: `source run.sh` ( Linux|Mac ) 或 `run.bat` ( Windows )
> 运行单个脚本: `source run.sh sample/test.spec.js` ( Linux|Mac ) 或 `run.bat sample/test.spec.js` ( Windows )
5. 获得测试报告和单步截图
> ./reports/index.html
> ./reports/index.xml (JUnit)
> ./reports/index.json
> ./screenshots/
## 更多平台
<p align="center">
<a href="//macacajs.github.io">
<img
alt="Macaca"
src="https://macacajs.github.io/macaca-logo/svg/monkey.svg"
width="200"
/>
</a>
</p>
1. 安装并且启动macaca server:
> 安装 [Macaca](http://macacajs.github.io)
> 连接你的手机或模拟器
> `macaca server --port 4444`
2. 初始化测试工程
> 创建新文件夹
> `uirecorder init --mobile`
3. 开始录制测试用例
> `uirecorder --mobile sample/test.spec.js`
4. 运行测试用例
> 运行所有脚本: `source run.sh` ( Linux|Mac ) 或 `run.bat` ( Windows )
> 运行单个脚本: `source run.sh sample/test.spec.js` ( Linux|Mac ) 或 `run.bat sample/test.spec.js` ( Windows )
5. 获得测试报告和单步截图
> ./reports/index.html
> ./reports/index.xml (JUnit)
> ./reports/index.json
> ./screenshots/
# 文档翻译
1. [中文使用手册](/doc/zh-cn/readme.md)
# License
UIRecorder is released under the MIT license.
# 感谢
* jWebDriver: [https://github.com/yaniswang/jWebDriver](https://github.com/yaniswang/jWebDriver)
* chai: [https://github.com/chaijs/chai](https://github.com/chaijs/chai)
* macaca-mocha-parallel-tests: [https://github.com/macacajs/macaca-mocha-parallel-tests](https://github.com/macacajs/macaca-mocha-parallel-tests)
* macaca-reporter: [https://github.com/macacajs/macaca-reporter](https://github.com/macacajs/macaca-reporter)