nightwatch API

Expect

NightWatch在0.7版本 新推出一种BDD-style界面 来执行断言,叫做Expect.它以Chai Expect断言库为参考,比传统的asset界面更灵活更高效.

Language Chains

以下命令仅作辅助，提高断言可读性。本身不具有测试能力

• to
• be
• been
• is
• that
• which
• and
• has
• have
• with
• at
• does
• of

.equal(value)/.contain(value)/.match(regex)

判断组件是否

• 值是否与指定值相等
  browser.expect.element('#main').text.to.equal('The Night Watch');
• 值是否包含指定值
  browser.expect.element('#main').text.to.contain('The Night Watch');
• 是否有指定样式
  browser.expect.element('#main').to.have.css('display').which.equals('block');

.not

取反 写在equal,contain，match前面 text.to.not.equal()

.before(ms)/.after(ms)

在指定的时间再执行一次断言，可与任何断言配合使用，使其可以再执行

• browser.expect.element('#main').text.to.contain('The Night Watch').before(1000);

• browser.expect.element('#main').text.to.not.contain('The Night Watch').after(500);

.a(type) /an

检查指定组件的类型是否与预期相符。参数与：type,message(optional)

• browser.expect.element('#q').to.be.an('input');
• browser.expect.element('#q').to.be.an('input', 'Testing if #q is an input');
• browser.expect.element('#w').to.be.a('span');

.attribute(name)

检查元素的某个属性是否存在，是否有预期的值（optional）

• browser.expect.element('body').to.have.attribute('data-attr');

.css

同attribute

• browser.expect.element('#main').to.have.css('display').which.matches(/some\ value/);

.enabled

检查元素现在是否可用

• browser.expect.element('#weblogin').to.be.enabled;
• browser.expect.element('#main').to.not.be.enabled;

.present

检测元素是否在dom中出现

• browser.expect.element('#main').to.be.present;

.select

检测下拉框，单选框，复选框当前是否被选中

.text

检测组件是否有指定文本/表达式,可与contains,equals,matches配合使用

• .text.to.match(/The\ Night\ Watch/)

.value

同text

• .to.have.value.which.contains/.not.equals/.that.equals

.visible

是否可见

 

assert

经典的assert&verify断言库在NightWatch仍然可用.它们作用相同,不同之处在于当前断言失败后assert会跳过之后的断言,结束测试(相当于break);verify会跳过当前断言,输出错误报告,继续执行其他断言(相当于continue).

.attributeContains()

检查某元素给定的属性是否有预期的值
参数:

1. selector,用来定位元素
2. attribute,属性名
3. expected,期望包含的值
4. message (optional),测试结果中的信息说明

eg. browser.assert.attributeContains('#someElement', 'href', 'google.com');

.attributeEquals()

同上(attributeContains)

.containsText()

参数:

1. cssSelector
2. expectedText
3. msg(Optional)

eg. browser.assert.containsText("#main", "The Night Watch");

.cssClassPresent()

检查元素是否有指定的CSS类名
参数:

1. cssSelector,用来定位元素
2. className,期望有的类名
3. message (optional),测试结果中的信息说明

eg. browser.assert.cssClassPresent("#main", "container");

.cssClassNotPresent()

楼上(.cssClassPresent)取反

.cssProperty()

检查元素的指定属性是否是期望的状态
参数:

1. cssSelector,用来定位元素
2. cssProperty,属性
3. expected,
4. message (optional),测试结果中的信息说明

eg. browser.assert.cssProperty("#main", "display", "block");

.elementPresent()

dom中是否含有指定元素

• browser.assert.elementPresent("#main");

.elementNotPresent()

楼上取反

.hidden()

检查指定元素是否在页面不可见

• browser.assert.hidden(".should_not_be_visible");

.title()

检查页面标题是否是指定标题

• browser.assert.title("Nightwatch.js");

.urlContains()

检查当前的URL是否包含指定值

• browser.assert.urlContains('google');

.urlEquals()

• browser.assert.urlEquals('http://www.google.com');

.value()

检查指定的表单元素的值 是否与指定值相等

• browser.assert.value("form.login input[type=text]", "username");

.valueContains()

• browser.assert.valueContains("form.login input[type=text]", "username");

.visible()

• browser.assert.visible(".should_be_visible");

Commands

Commands可在页面上执行不同的操作,通常包含两个及以上的页面驱动协议行为.

回调函数

以下的方法均支持回调函数.回调函数将在command完成之后执行

.clearValue()

可清理文本域或文本输入框里的内容

• client.clearValue('input[type=text]');

.click()

模仿点击事件

• client.click("#main ul li a.first");

感觉更适合与回调函数配合使用 
browser.click("#main ul li a.first", function(response) { 
this.assert.ok(browser === this, "Check if the context is right."); 
this.assert.ok(typeof response == "object", "We got a response object."); 
});

.closeWindow()

关闭当前窗口,当你使用多个窗口时适用

.deleteCookie()

删除cookie