当一个应用的复杂度、大小在增加时,使得依靠人工去测试新特性的可靠性、抓Bug和回归测试是不切实际的。
为了解决这个问题,我们建立了Angular Scenario Runner,模仿用户的操作,帮助我们去验证angular应用的健壮性。
一、 总括
我们可以在javascript中写情景测试(scenario test),描述我们的应用发生的行为,在某个状态下给与某些互动。一个情景包含一个或者多个”it”块(我们可以将这些当作对我们应用的要求),依次由命令(command)和期望(expectation)组成。command告诉Runner在应用中做某些事情(例如转到某个页面或者单击某个按钮),expectation告诉runner去判断一些关于状态的东西(例如某个域的值或者当前的URL)。如果任何expectation失败了,那么runner标记这个”it”为”false”,然后继续下一个”it”。Scenario也可以拥有” beforeEach”和” afterEach”block,这些block会在每一个”it”block之前或者之后运行,不管它是否通过。
除了上述元素外,scenario也可以包含helper function,避免在”it”block中有重复的代码。
这里是一个简单的scenario例子:
describe('Buzz Client', function() { it('should filter results', function() { input('user').enter('jacksparrow'); element(':button').click(); expect(repeater('ul li').count()).toEqual(10); Input('filterText').enter('Bees'); expect(repeater('ul li').count()).toEqual(1); }); });
这个scenario描述了网络客户端的要求,明确地,它应该有过滤user的能力。它开始的时候,输入了一个值到”user”输入框中,单击页面上唯一的按钮,然后它验证是否有10个项目列表。然后,它输入”Bees”到”filterText”的输入框中,然后验证那个列表是不是会减少到只有一个项。
下面的API章节,列出了在Runner中可用的command和expectation。
二、 API
源代码:https://github.com/angular/angular.js/blob/master/src/ngScenario/dsl.js
pause()
暂停执行测试,直到我们在console中调用resume()(也可以在Runner界面中点击resume链接)
sleep(seconds)
暂停测试执行N秒。
browser().navigateTo(url)
在tset frame中加载指定url。
browser().navigateTo(url,fn)
在test frame中加载fn返回的url地址。这里的url参数只是用作测试输出。当目的url是动态的时候可以使用这个API(写测试的时候,地址还是未知的)。
browser().reload()
在test frame中刷新当前加载的页面。
browser().window().href()
返回test frame当前页面的window.location.href。
browser().window().path()
返回test frame当前页面的window.location.pathname。
browser().window().search()
返回test frame当前页面的window.location.search。
browser().window().hash()
返回test frame当前页面的window.location.hash(不包含#)。
browser().location().url()
返回test frame 当前页面的$location.url()的返回结果($location)
browser().location().path()
返回test frame 当前页面的$location. path ()的返回结果($location)
browser().location().search()
返回test frame 当前页面的$location. search ()的返回结果($location)
browser().location().hash()
返回test frame 当前页面的$location. hash ()的返回结果($location)
expect(future).{matcher}
判断给定的期望(future)值是否满足matcher。所有API的声明都返回一个在它们执行完毕之后获取到的一个指定值的future对象。matcher是使用angular.scenario.matcher定义的,他们使用futures的值去执行expectation。例如:
expect(browser().location().href()).toEqual(‘');
expect(future).not().{matcher}
判断给定future的值是否与指定的matcher的预期相反。
using(selector,label)
Scopes the next DSL element selection.(大概是限定选择器的作用域,label估计是用于测试输出)
例子:
using('#foo', "'Foo' text field").input('bar')
binding(name)
返回第一个与指定的name匹配的绑定(也许是跟ng-bind相关)。
input(name).enter(value)
输入指定的value到name指定的表单域。
input(name).check()
选中或者解除选中指定name的checkbox。
input(name).select(value)
选中指定name的radio中值为value的input[type=” radio”]。
input(name).val()
返回指定name的input的当前值。
repeater(selector,label).count()
返回与指定selector(jQuery selector)匹配的repeater的行数。label只用作测试输出。
repeater('#products table', 'Product List').count() //number of rows
repeater(selector,label).row(index)
返回一个数组,绑定指定selector(jQuery selector)匹配的repeater中指定index的行。label仅仅用于测试输出。
repeater('#products table', 'Product List').row(1) //all bindings in row as an array
repeater(selector,label).column(binding)
返回一个数组,值为指定selector(jQuery selector)匹配的repeater中符合指定binding的列。label仅仅用于测试输出。
repeater('#products table', 'Product List').column('product.name') //all values across all rows in an array
select(name).option(value)
选择指定name的select中指定value的option。
select(name).option(value1,value2)
选择指定name的select中指定value的option(多选)。
element(selector,label).count()
返回与指定selector匹配的元素的个数。label仅仅用作测试输出。
element(selector,label).click()
单击与指定selector匹配的元素。label仅仅用作测试输出。
element(selector,label).query(fn)