nightwatch API

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()

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

selector,用来定位元素

attribute,属性名

expected,期望包含的值

message (optional),测试结果中的信息说明

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

.attributeEquals()

同上(attributeContains)

.containsText()

参数:

cssSelector

expectedText

msg(Optional)

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

.cssClassPresent()

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

cssSelector,用来定位元素

className,期望有的类名

message (optional),测试结果中的信息说明

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

.cssClassNotPresent()

楼上(.cssClassPresent)取反

.cssProperty()

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

cssSelector,用来定位元素

cssProperty,属性

expected,

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(‘‘);

.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