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节点

Assertions

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

Commands

• $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节点查找错误
  • 浏览器端函数执行错误时抛出错误