monitor.sendError/monitor.error; 发送错误信息

monitor.sendLog/monitor.log; 发送描述信息（不是一个错误）

monitor.sendWarn/monitor.warn; 发送警告信息

monitor.sendSMS/monitor.sms; 发送短信通知

monitor.sendMail/monitor.mail; 发送邮件通知

monitor.complete(); 显示调用该单测执行完成，建议每一个单测都显示调用complete方法

monitor.run 链式执行方法体

monitor.jsonp(callback_name,handle) 处理页面jsonp请求，验证数据等

monitor.step(xxx,handler) 录制页面行为后执行每一步的函数(已废弃，但原有功能不变)

monitor.createAction(option) 创建一个行为对象，手写用户行为单侧代码的时候使用

代码实例

monitor.run方法，run方法可以链式调用

monitor.run(function(){
    //发送错误信息
    monitor.sendError("xxx");
    // or
    monitor.error("xxx");
}).complete();

/*monitor.sendLog("xxx")*/
monitor.run(function(){
    monitor.sendLog("xxx");
    // or
    monitor.log("xxx");
}).complete();

链式调用run

monitor.run(function(){
    if(document.title.indexOf("百度") !== 0){
        monitor.sendError("页面title错误");
    }
}).run(function(){
    if(!document.getElementById("test")){
        monitor.sendWarn("ID为test的DOM元素不存在");
        // or
        monitor.warn("xxxx");
    }
}).complete();

循环发送

monitor.run(function(){
    var links = document.getElementsByTagName("a");
    for(var i = 0,len = links.length; i < len; i++){
        if(links[i].getAttribute("href").indexOf("http://") == -1){
            monitor.sendWarn("页面存在相对链接：" + links[i].href);
        }
    }
    monitor.complete();
});

monitor.jsonp

//这样调用之后，页面上发起的该jsonp_callback的jsonp请求，就会处理下面的回调函数，原有的逻辑也会正常执行
monitor.jsonp("window.jsonp_callback",function(data){
    if(!data.name){
        monitor.error("name数据不存在");
    } 
});

monitor.setp

//需要特别注意一点的是：step第一个参数后面的数字，是时间序列，都是相对于第一个step的时间间隔
//即是每一个step的执行时间，都是减去第一个step后的时间序列，按照这个序列执行每一个step
//因此，在手动写wait行为的时候，需要注意一下，时间数值要比上一个step中的时间数值大就行

/*
目前monitor.step方法有几种类型：
type: 对一个输入框(input,textarea,select) 赋值
click: 触发一个元素的click操作
mouseover: 触发一个元素的mouseover操作
wait: 等待几秒后继续执行（这个主要是手写的step类型）
*/

// type、click、mouseover类型的最后一个回调函数的参数，就是当前的DOM元素

monitor.step("type::#op_train_start::本::0",function(el){})
.step("type::#op_train_start::::239",function(el){})
.step("type::#op_train_start::b::1479",function(el){})
.step("click::#tangram-suggestion--TANGRAM__3-item4::3346",function(el){})
.step("type::#op_train_end::s::5160",function(el){})
.step("click::#tangram-suggestion--TANGRAM__g-item4::7137",function(el){})
.step("click::#1>tbody>tr>td>font:nth-child(3)>div:nth-child(1)>table>tbody>tr:nth-child(1)>td:nth-child(3)>a::9242",function(el){})
.step("click::#1>tbody>tr>td>font:nth-child(3)>div:nth-child(1)>table>tbody>tr:nth-child(1)>td:nth-child(3)>a::10305",function(el){});


//wait类型的step:
monitor.step("click::#example::0")
.step("wait::2000",function(){
    //这里编写点击2s后的验证代码
});

monitor.createAction(option)

/* Tip：凡是涉及到传递目标元素参数的，都支持selector或者DOM元素的引用的方式 */

/* 创建一个行为（一个case里面可以声明多个行为）*/
var action = monitor.createAction();
//可以带个参数，指定初始目标元素
var action = monitor.createAction({
    target : "#txt"
});

//目前Action下的方法有：type/click/clickOnce/mouseover/mouseup/mousedown/wait/complete/end，type、click、mouseover、wait方法支持链式调用
// type: 对一个输入框(input,textarea,select) 赋值
// click: 触发一个元素的click操作(会使用三种方式去触发：原生的fireEvent、jQuery trigger、调用元素的click方法)
// clickOnce : 触发一个元素的click操作（只使用一种方法触发事件：原生的fireEvent）
// mouseover : 触发一个元素的mouseover操作
// mouseup : 触发一个元素的mouseup操作
// mousedown : 触发一个元素的mousedown操作
// wait: 等待多长时间继续执行下一个步骤
// complete/end: 显示调用该行为结束，并且设置该单侧已完成（如果有多个行为，则最后一个行为调用complete/end方法即可，如果只有一个，那么该行为调用end以结束该单侧）


/*
 * 特别说明一下click/clickOnce的存在目的：有些场景去触发click事件，使用上面三种方法中的某一种都没法触发，
 * 所以结合三种情况去触发，
 * 但是这样的话，有可能事件会被触发三次，或者被触发一次，其他的触发无效，这是为了保证click一定会被触发。
 * clickOnce就是为了上面的被触发多次后本身出现问题，所以它就是用原生的fireEvent去触发一次。
 */


/* 开始执行行为 */
action.type("123456");
//或者指定目标元素
action.type("#txt","123456");
//or
action.type(document.getElementById("txt"),"123456").complete();
//or
action.type("123456",function(el){
    console.log(el.value);
}).complete();

//带点击行为（mouseover行为类似）
action.type("#txt","12345").click().complete();
//带一个回调，回调函数的参数就是目标元素的DOM引用
action.type("#txt","123").wait(1000).click(function(el){
    console.log(el.value);
}).complete();

//在行为中也可以重新指定目标元素
action.type("123").wait(2000).click("#btn",function(el){}).complete();

//其实，wait/end方法也是有回调函数的，可以用在一些点击按钮发送jsonp的场景里面，验证效果
action.type("#txt","123").wait(2000).click("#btn").wait(2000,function(){
    console.log($("#txt").val());
});

//录制出来的代码如下所示：
var action = monitor.createAction();
.type("#op_hangban_start","s",function(el){})
.wait(654,function(){})
.click("#tangram-suggestion--TANGRAM__3-item5",function(el){})
.wait(2248,function(){})
.type("#op_hangban_end","s",function(el){})
.wait(639,function(){})
.click("#tangram-suggestion--TANGRAM__g-item7",function(el){})
.complete(function(){});

monitor.define(name,handler) 定义一个module通用测试代码，供其他的测试代码使用

monitor.require(names,handler) 使用一个或者多个modules通用测试代码的功能

代码实例

monitor.define(name,handler)

/*
 * monitor.define接口，定义一个module的自定义通用测试代码，比如封装一些通用的测试代码，避免重复的代码编写
 * define方法不支持依赖的功能，每一个define都是一个独立的通用测试代码，供其他的测试用例使用
 * 它的返回值可以是任何东西，默认是{}空对象
 */

monitor.define("module",function(){
    var mod = {};

    mod.sayHello = function(){
        alert("hello module");
    } 

    return mod;
});

monitor.require(names,handler)

/*
 * monitor.require接口，可以使用一个module，也可以传入多个modules，当然，参数也可以只是一个函数
 */

//传入一个module
monitor.require("module",function(module){
    module.sayHello(); 
});

//传入多个modules
monitor.require(["module1","module2"],function(module1,module2){
    module1.sayHello();
    module2.sayHi(); 
});

//啥module都没有
monitor.require(function(){
   //code here ... 
});

should(xxx) should方法，类似与jQueryçš„$

should(xxx).be() be介词

should(xxx).have() have介词

should(xxx).has() has介词

should(xxx).not() not介词，相反的意思

should(xxx).and() and介词

should(xxx).to() to介词

should(xxx).have().property(xxx)/should().haveProperty()/should().hasProperty() 判断是否有属性，主要对object类型

should(xxx).not().have().property(xxx) 判断没有该属性，其它的类同

should(xxx).have().attr(xxx)/should().haveAttr()/should().hasAttr() 判断是否有attribute属性，主要对dom元素

should(xxx).beTrue/beTrues|beFalse/beFalse 判断是否为true(存在)å’Œfalse(不存在)

should(xxx).have().ownProperty(xxx)/should().hasOwnProperty()

should(xxx).have().lengthOf(number).should().beLengthOf()

should(xxx).not().have().property(xxx)

should(xxx).have().keys([xxx])/should().haveKeys()/should().hasKeys()

should(xxx).have().include(string) 判断是否包含某个内容(object->propery,array->item)

should(xxx).be().empty()/should().beEmpty() 判断是否为空(dom,string,array,object)

should(xxx).be().a(xxx)/should().beA() 判断是什么类型(dom,string,array,object,null,undefined...)

should(xxx).be().above(number)/should().beAbove() 判断给定的值是否大于某个数

should(xxx).be().below(number)/should().beBelow() 判断给定的值是否小于某个数

should(xxx).equal(xxx)/should(xxx).beEqual(xxx) 判断给定的值是否跟参数的相等

should(xxx).exist() 判断是否存在

should(xxx).be().match(regexp) 正则匹配

should(xxx).have().child(dom)/should().haveChild()/should().hasChild() 是否含有直接子元素

should(xxx).have().parent(dom)/should().haveParent()/should()/hasParent()

should(xxx).have().next(dom)/should().haveNext()/should().hasNext()

should(xxx).have().prev(dom)/should().havePrev()/should().hasPrev()

should(xxx).have().prev(dom).fail/success(function(){}) failå’Œsuccess在前面判断是否ok的时候调用

should(xxx).not().be().empty().error(xxx) 如果有错误，则发送错误信息

should(xxx).have().include(xxx).mail(xxx) 如果有错误，则发送邮件信息

should(xxx).have().include(xxx).sms(xxx) 如果有错误，则发送短信信息

should(xxx).have().include(xxx).log(xxx) 如果有错误，则发送日志信息

should(xxx).have().include(xxx).warn(xxx) 如果有错误，则发送警告信息

should(xxx).be().visible() 判断指定的DOM元素应该是显示状态，只针对display

should(xxx).be().hide() 判断指定的DOM元素应该是隐藏状态，只针对display

should(xxx).haveHrefKeys(keys) 判断超链接DOM元素的href属性中是否包含指定的多个key是否有指定的值

should(xxx).haveHrefKey(key,value) 判断超链接DOM元素的href属性中是否包含指定的一个key是否有指定的值

should(xxx).haveFormKeys(keys) 判断一个form表单中指定的全部name的控件的值是否等于指定的值

should(xxx).haveFormKey(key,value) 判断一个form表单指定的name的控件的值是否等于指定的值

代码实例

should介词

should("xxx").be()
should("xxx").not()
should("xxx").and()
should("xxx").have()
should(xxx).has()

should(xxx).have().property

should({name : 1}).have().property("name").fail(function(){
    monitor.sendError("have not property");
}).success(function(){
    cnosole.log("have property");
});

should(xxx).have().property

should({name : 1}).have().property("name").fail(function(){
    monitor.sendError("have not property");
});

should(xxx).have().attr

should(document.getElementById("test")).have().attr("cid").fail(function(){
    monitor.sendError("have not attribute");
});

should(xxx).not().have().property

should({name : 1}).not().have().property("name").fail(function(){
    monitor.sendError("it have property");
});

should(xxx).beTrue()/beTrues()|beFalse()/beFalses()

should(1).beTrue().error("不为true");

should(xxx).have().keys

should([1,2,5,6,7,8]).have().keys([1,2,7]).fail(function(){
    monitor.sendError("not have all the keys");
});

should(xxx).include

should([1,2,4]).include(2).fail(function(){
    monitor.sendError("not include");
});

should(xxx).be().empty

should([]).be().empty().fail(function(){
    monitor.sendError("not empty");
});

should(xxx).be().a

should({name : 1}).be().a("object").fail(function(){
    monitor.sendError("not a object");
});

should([1,2,4]).be().a("array").fail(function(){
    monitor.sendError("not a array");
});

should(document.getElementById("test")).be().a("dom").faild(function(){
    monitor.sendError("not a dom element");
});

should(xxx).have().match

should("youname").have().match(/name/).fail(function(){
    monitor.sendError("not match");
});

should(xxx).have().parent

should(document.getElementById("test")).have().parent(document.getElementById("parent")).fail(function(){
    monitor.sendError("not have id is parent");
});

should链式调用

should({name : 1}).not().be().empty().fail(function(){
    monitor.sendError("it is empty");
}).and().have().property("name").fail(function(){
    monitor.sendError("have no name property");
});

should(xxx).error()/warn()/log()/sms()/mail()

should("").not().be().empty().error("指定的参数不为空");
should("").not().be().empty().warn("指定的参数不为空");
should("").not().be().empty().log("指定的参数不为空");
should("").not().be().empty().sms("指定的参数不为空");
should("").not().be().empty().mail("指定的参数不为空");

should(xxx).be().visible()/should(xxx).be().hide()

should($("#container")).be().visible().error("没有正常显示");
should($("#container")).be().hide().error("没有正常关闭");

should(xxx).haveHrefKeys(keys)

//判断一个超链接的href属性参数中是否包含了wd和pn参数，并且值是否相等
should($("#page>a:nth-child(11)")).haveHrefKeys({
    "wd" : "123",
    "pn" : 10
}).error("error");

should(xxx).haveHrefKey(key,value)

//如果不指定value，则会验证该key是否存在
should($("#page>a:nth-child(11)")).haveHrefKey("wd").error("error");

//验证是否等于指定的值
should($("#page>a:nth-child(11)")).haveHrefKey("wd","我们").error("error");

should(xxx).haveFormKeys(keys)

//指定的key是输入控件的name属性的值
should("#example-form").haveFormKeys({
    "username" : "safy",
    "password" : "iloveyou"
}).error("error message");

should(xxx).haveFormKey(key,value)

should("#example-form").haveFormKey("username","safy").error('error message');

driver.find_element_by_id() 通过ID获取DOM元素

driver.find_element_by_name() 通过name属性值获取第一个匹配的DOM元素

driver.find_element_by_tag_name() 通过tagName获取第一个匹配的DOM元素

driver.find_element_by_class_name() 通过className获取第一个匹配的DOM元素

driver.find_element_by_link_text() 通过链接的内容获取第一个匹配的DOM元素

driver.find_element_by_partial_link_text() 通过超链接的部分内容获取第一个匹配的DOM元素

driver.find_element_by_css_selector() 通过CSS Selector获取第一个匹配的DOM元素

driver.find_element_by_xpath() 通过XPath获取第一个匹配的DOM元素

driver.find_elements_by_name() 通过name属性值获取全部匹配的DOM元素

driver.find_elements_by_tag_name() 通过tagName获取全部匹配的DOM元素

driver.find_elements_by_class_name() 通过className获取全部匹配的DOM元素

driver.find_elements_by_link_text() 通过链接的内容获取全部匹配的DOM元素

driver.find_elements_by_partial_link_text() 通过链接部分内容获取全部匹配的DOM元素

driver.find_elements_by_css_selector() 通过CSS Selector获取全部匹配的DOM元素

driver.find_elements_by_xpath() 通过xpath获取全部匹配的DOM元素

driver.find_element(By.NAME,"xxx") 通过name属性值获取第一个匹配的DOM元素

driver.find_element(By.XPATH,"xxx") 通过XPath获取第一个匹配的DOM元素

driver.find_element(By.CLASS_NAME,"xxx") 通过className获取第一个匹配的DOM元素

driver.find_element(By.TAG_NAME) 同上

driver.find_element(By.ID) 同上

driver.find_element(By.CSS_SELECTOR) 同上

driver.find_element(By.LINK_TEXT) 同上

driver.find_element(By.PARTIAL_LINK_TEXT) 同上

driver.find_elements(By.NAME,"xxx") 同上

driver.find_elements(By.XPATH,"xxx") 同上

driver.find_elements(By.CLASS_NAME,"xxx") 同上

driver.find_elements(By.TAG_NAME) 同上

driver.find_elements(By.ID) 同上

driver.find_elements(By.CSS_SELECTOR) 同上

driver.find_elements(By.LINK_TEXT) 同上

driver.find_elements(By.PARTIAL_LINK_TEXT) 同上

driver.execute_script(xxx) 执行一段js代码，并获取执行返回结果

代码实例

driver

//driver这个对象是内置的，在编写单侧代码的时候直接调用即可，它包含上面罗列的方法，上面的方法调用后，
//返回一个webElement的对象，webElement还可以继续调用上面的方法，获取子元素、获取属性值、each、click、submit等更多的操作

driver.find_element_by_id()

var input = driver.find_element_by_id("kw");
should(input.get_attribute("value")).be().equal("123").error("xxxx");

driver.find_element_by_name()

//获取一个name
var input = driver.find_element_by_name("kw");
should(input.get_attribute("value")).be().equal("123").error("xxxx");

//获取多个name
var inputs = driver.find_elements_by_name("user");
inputs.each(function(index,item){
    should($(item).val()).be().equal("123").error("xxx");
})

driver.find_element_by_tag_name()

//获取第一个select控件
var selectElement = driver.find_element_by_tag_name("select");
var optionsElement = selectElement.find_element_by_tag_name("option");
optionsElement.each(function(index,item){
    // code here ...
});

driver.find_element_by_class_name()

var inputElement = driver.find_element_by_class_name(".kw");
inputElement.send_keys("123");
inputElement.click();
// or
var formElement = driver.find_element_by_class_name(".myform");
forElement.submit();

driver.find_element_by_link_text()

// HTML : <a href="http://www.baidu.com">baidu link</a>

var link = driver.find_element_by_link_text("baidu link");
link.get_attribute("href");

driver.find_element_by_partial_link_text()

// HTML : <a href="http://www.baidu.com">baidu link</a>

var link = driver.find_element_by_partial_link_text("baidu");
link.get_attribute("href");

driver.find_element_by_css_selector()

var exampleElement = driver.find_element_by_css_selector("#example");
link.get_text();

driver.find_element(By.CSS_SELECTOR,"xxx")

/*
 * By现在有下面几种类型，对应着上面的方法：
 * ID,NAME,CLASS_NAME,TAG_NAME,LINK_TEXT,PARTIAL_LINK_TEXT,CSS_SELECTOR,XPATH
 */

var exampleElement = driver.find_element(By.CSS_SELECTOR,"#example");
//获取#example下面的全部div子元素
exampleElement.find_elements(By.TAG_NAME,"div").each(function(index,item){
    // code here ... 
});

// 其他By的例子同上

driver.execute_script()

var labels = driver.find_elements_by_tag_name("label");
var inputs = driver.execute_script(
    "var labels = arguments[0],inputs = [];" + 
    "for(var i =0; i < labels.length; i++){" + 
    "   inputs.push(document.getElementById(labels[i].getAttribut('for')));" + 
    "}" +
    "return inputs;",
    labels.get_elements() //获取到DOM元素的集合
);

验证某个按钮的事件是否正常执行

var action = monitor.createAction();
action.click("#example",function(el){
    //在这里验证该元素的变化，比如点击后背景发生变化
    should($(el).css("backgroundColor")).be().equal("#c00").error("背景颜色没变化");
})
.wait(2000,function(){
    //在这里验证点击后产生的效果，比如验证点击后异步请求的效果：内容是否为空
    should($("#content").html()).be().exist().error("异步请求内容为空");
})
.complete();

判断某个节点的文本内容是否等于指定的值

should($("#example").text()).be().equal("xxxx");

点击某个按钮，发送JSONP异步请求，验证结果并验证数据

var action = monitor.createAction();
action.click("#example")
.wait(2000,function(){
   //这个回调函数里面，可以写额外的测试代码去判断页面的效果，比如元素显示隐藏，数据是否展示，数据提示是否ok 
})
.complete(); //结束测试

//验证JSONP异步数据本身内容(monitor.jsonp方法的第一个参数，就是jsonp回调执行的函数名，就是cb参数传的值)
monitor.jsonp("window.json_callback",function(json){
    if(json.status != 0){
        monitor.error("数据错误")
    }
});

点击Tab组件的每一个Tab选项卡，并验证每一个tab内容是否正常显示出来

//这个功能可以使用录制的方式，验证是否正常显示，需要在回调函数中简单写一点代码来验证
var action = monitor.createAction();
action.click("#tab2",function(el){
    //这部分手写代码验证
    should($("#tab2-box").css("display")).beEqual("block").error("tab显示不正确");  
})
.wait(1000)
.click("#tab3",function(el){
    should($("#tab3-box").css("display")).beEqual("block").error("tab显示不正确");  
})
.complete();

判断某个阿拉丁的结果里面图片数量至少大于1个

//对于一些判断阿拉丁数据是否存在的，先需要判断一下该条阿拉丁是否存在，
//否则，某个query下，该阿拉丁不存在了，也去判断，就会出现错误、误报了。
//因此，首先要判断该阿拉丁是存在的，才能做接下来的判断
if(monitor.util.hasAladdin("tieba2")){
    should($("table[tpl=tieba2] img").size()).be().above(0).error("一个图片都不存在");
}

点击类似“更多”，“收起“等操作，DOM元素的显示和隐藏

var action = monitor.createAction();
action.click("#open",function(){
    should($("#hide-box")).be().visible().error("没有正常显示容器");
})
.wait(1000)
.click("#close",function(){
    should($("#hide-box")).be().hide().error("没有正常隐藏容器");
})
.complete();

点击按钮，打开新窗口，判断拼装的URL是否正确

//比如一些机票、火车票查询的阿拉丁，填写from、to然后点击查询，跳到第三方网站
var action = monitor.createAction();
action.click("#example-btn",function(el){
    should($(el).attr("href")).match(/wd=([^&]+)/).error("URL拼装有问题");
})
.complate();

IP查询，或者手机号码查询的阿拉丁，对于输入错误的内容，会显示错误提示的验证

var action = monitor.createAction();
action.type("#cell_txt","sdfsdf")
.click("#btn")
.wait(2000,function(){
    should($("#error_tip")).be().visible().error("错误提示未显示");
})
.complete();

对于一些Sug功能的验证，比如选择某个sug后，验证输入框中是否是选择的值

//首先，对于sug的功能，请使用录制功能进行录制用户行为，自动生成代码，如下：

var action = monitor.createAction();
action.type("#op_hangban_start","s",function(el){})
.wait(491,function(){})
.mouseover("#tangram-suggestion--TANGRAM__3-item0",function(el){})
.mouseover("#tangram-suggestion--TANGRAM__3-item4",function(el){})
.wait(422,function(){})
.click("#tangram-suggestion--TANGRAM__3-item4",function(el){
    //这里就是点击了sug的某一个选项，然后在这里可以做验证了（其他类似的验证，都可以通过这样方式）
    //这里的el参数，就是当前点击的元素
    should($(el).text()).be().equal($("#op_hangban_start").val()).error("sug的值对不上");
})
.wait(1150,function(){})
.type("#op_hangban_end","f",function(el){})
.wait(481,function(){})
.mouseover("#tangram-suggestion--TANGRAM__g-item0",function(el){})
.wait(150,function(){})
.mouseover("#tangram-suggestion--TANGRAM__g-item1 span.op_hangban_hilight",function(el){})
.wait(518,function(){})
.click("#tangram-suggestion--TANGRAM__g-item1 span.op_hangban_hilight",function(el){})
.complete(function(){});