nightwatch测试扩展函数

提供nightwatch部分扩展函数

安装

``
npm install nightwatch-extend --save-dev
`

使用

在 Nightwatch 配置文件中增加:
`
{
"custom_commands_path": ["./node_modules/nightwatch-helpers/src/commands"],
"custom_assertions_path": ["./node_modules/nightwatch-helpers/src/assertions"]
}
``

包含内容

> 所有文字text除了空格外其他内容和独立dom节点内的文字务必全部相同，否则就查找不到对应dom节点

$3

* $hasText(text) 存在文本内容为text的节点（文本会过滤空格，避免空格影响判断）
* $notText(text) 不存在文本内容为text的节点（文本会过滤空格，避免空格影响判断）
* $labelValue(labe, value, msg) 根据label查找到的输入框内的值等于指定值

$3

* $msg(msg) 展示消息
* $waitForText(text, [timeout = 10000], [cb]) 等待展示文本节点
* $waitForNotText(text, [timeout = 10000], [cb]) 等待文本消失
* $hasText(text, cb) 判断是否存在text节点，存在则回调函数result的value为true
* $waitForUrl(urlOrReg, [timeout = 10000], [cb]) 等待跳转到指定链接
* $clickText(innerText, cb) 点击根据文本找到到的dom节点
* $clickClosestText(start, target, cb) 点击start节点临近的target节点
* $labelValue(labelText, inputValue) 根据label查找输入框并设置值
* $clearValue(selectorOrText, cb) 清空输入框的值
* $moveToText(text, cb) 移动鼠标到text节点
* $call(func) 执行func, 非异步(执行环境是命令端)
* $chain(func1, func2, func3...) 命令端链式操作，每个函数最后一个参数为next，执行next(arg1, arg2...)即可将参数传入下一个函数
* $exec(func, [args], [cb]) 浏览器端执行函数
* $wait(func, [args], [timeout = 5000], [cb]) 浏览器端反复执行函数直到函数返回true(!value为true)则结束执行
* $catchResult(result, msg) 根据result判断是否有错误（result.value.message），假如有错误就中断执行并展示错误信息
* $recordCookies() 记录当前页面的cookie信息
* $setCookiesFromRecord(cb) 根据上次执行时记录的cookie向浏览器写入cookie信息（注意域名一致）

nightwatch环境依赖

* node 版本6.0及以上
* java 版本1.8及以上（使用命令行java -version检查版本，，低于1.8请更新jdk）
* chrome 版本59及以上

开发注意问题

* 客户端函数的error对象不能被序列化，所以错误不能作为执行结果返回
* 客户端返回的dom节点，到执行脚本时只会保留一个Element，结构{ELEMENT: '....'}
* 带有延迟触发complete事件时，务必保证先返回this对象

待完成

* $dragTo(from, target) 拖动动作

version

* v1.0.6
- fix: 查找节点时不查找隐藏节点，避免后续操作失败
* v1.0.5
- 增加$clearValue命令
- $labelValue命令执行时先清空输入内容
* v1.0.4
- 增加assert.$labelValue
- 开放$exec并修复执行代码时传参错误
- 客户端脚本findDomByText根据文字查找dom节点可根据placeholder查询
* v1.0.3
- fix文档中引入路径错误
* v1.0.2
- 增加$call
- 增加$chain
- 增加$wait
- 增加$clickClosestText
- 增加$catchResult
- 增加$recordCookies和$setCookiesFromRecord
* v1.0.1
- 增加$msg
- fix节点查找错误
- 浏览器端函数执行错误时抛出错误