一、robot简介
robot是dojo框架中用来进行前端自动化测试的工具，doh主要目的在于单元测试，而robot可以用来模仿用户操作来测试UI。总所周知，Selenium也是一款比较流行的前端自动化测试工具，与Selenium相比robot的优点在于robot触发的浏览器事件是真正的用户操作事件，而Selenium中的事件属于“合成事件”。打个比方，用户在一个textbox元素上触发了mousedown事件，但是在触发mousedown事件之前，肯定会触发mouseover等事件。如果使用Selenium的工具的“合成事件”则不会触发mouseover等事件。对于使用dojo框架的开发者来说，robot更有利于同dijit交互，包括自定义dijit；当然最重要的一点是，在研究selenium的过程中，我发现Selenium有严重的浏览器兼容性问题！于是果断放弃。
言归正传，下面来具体介绍robot。robot主要有三部分组成：
doh/robot，这里面包含的是robot的核心内容，与dojo框架没有耦合关系，可以单独拿出去作为一个自动化测试工具。
require(["doh/robot"], function(doh){
...
});
dojo/robot，该模块使用dojo核心技术，支持doh/robot的全部方法，主要在doh/robot的基础上增加了两个方法：mouseMoveAt和scrollIntoView。
require(["dojo/robot"], function(doh){
...
});
dojox/robot，该模块在dojo/robot的基础上增加了两个重要方法：initRobot和waitForPageLoad。为什么说他们重要，因为他们可以再一个测试案例文件中控制其他的测试文件，后文将详细。
require(["dojox/robot"], function(doh){
...
});
二、基本步骤
doh/robot测试主要分为以下四步：
1、实例化一个doh.Deferred对象
2、执行交互命令
3、设置一个超时函数来验证交互结果
4、在runTest中返回deferred对象
这个事例中页面上一个文本输入框，包含hi两个字符，然后模仿用户输入“ again”动作。示例，robot实际上是一个applet第一次访问的话会提示安装。
require(["doh/runner", "doh/robot"], function(doh, robot){
doh.register("doh/robot",
{
name: "dojorobot1",
timeout: 6900,
setUp: function(){
document.getElementById('textbox').value="hi";
},
runTest: function(){
var d = new doh.Deferred();
robot.mouseMove(30, 30, 500);
robot.mouseClick({left:true}, 500);
robot.typeKeys(" again", 500, 2500);
robot.sequence(d.getTestCallback(function(){
doh.is("hi again", document.getElementById('textbox').value);
}), 900);
return d;
}
});
doh.run();
});
<form>
<input type="text" value="hi" id="textbox" style="position:absolute; left:0px; top:20px; font-family:system;"></input>
</form>
这里要说以下robot.sequence和d.getTestCallback这两个函数，sequence是robot中的一种同步方式书写的setTimeout，下文delay中会讲到这类方法的优势。doh.Deferred是doh中对dojo/Deferred的扩展，加入了许多方法，getTestCallback就是其中之一，该函数作用就在于交互命令执行完成后验证交互结果，并将结果告知测试框架从而决定显示绿条还是红条，通常一个测试案例中只有一处调用该方法。一下是该函数的源码：
getTestCallback: function(cb, scope){
var _this = this;
return function(){// 该函数返回一个闭包给sequence函数，从而在一定时间后调用该闭包
try{// 执行验证函数，监控结果，并将结果通知测试框架
cb.apply(scope||doh.global||_this, arguments);
}catch(e){
_this.reject(e);// 红条
return;
}
_this.resolve(true);// 绿条
};
},
三、API介绍
1、基本参数
下面以doh/Robot中typeKeys为例介绍一下robot API的基本参数，具体提供了哪些API可以在这里查看：API
typeKeys: function(/*String||Number*/ chars, /*Integer, optional*/ delay, /*Integer, optional*/ duration){
// summary:
// Types a string of characters in order, or types a dojo.keys.* constant.
//
// description:
// Types a string of characters in order, or types a dojo.keys.* constant.
// Example: robot.typeKeys("dijit.ed", 500);
//
// chars:
// String of characters to type, or a dojo.keys.* constant
//
// delay:
// Delay, in milliseconds, to wait before firing.
// The delay is a delta with respect to the previous automation call.
// For example, the following code ends after 600ms:
// robot.mouseClick({left:true}, 100) // first call; wait 100ms
// robot.typeKeys("dij", 500) // 500ms AFTER previous call; 600ms in all
//
// duration:
// Time, in milliseconds, to spend pressing all of the keys.
//
}
delay，顾名思义目的在于延迟，在webAPP中经常会有动画效果，等待动画结束后在执行click等事件，所以每一个API中与UI交互的函数都会提供这个方法。该方法内部使用setTimeout方法实现，既然这样，为什么不让用户直接使用setTimeout方法？原因在于dojo可以为我们自动调整一系列动作的执行顺序及间隔。举个例子，如果使用setTimeout，动作f1需要在300ms后执行，动作f2需要在f1之后100ms执行那就需要设置f2的timeout时间为400ms，这时候f1之前要加一个动作f3在f1之前200ms执行，
现在我们就需要挨个该f1跟f2的时间参数，如果f1之后有100个动作要执行。。。。God bless you。使用robot API提供的函数，我们只需要设置每个动作之间的时间间隔即可。
setTimeout(f1, 300);
setTimeout(f2, 400);
=>>
setTimeout(f3, 300);
setTimeout(f1, 500);
setTimeout(f2, 600);
var mask = query("div.ovwHighlight")[0];
robot.mouseMoveAt(mask, 200, 200);
robot.mousePress({left: true}, 100);
robot.mouseMoveAt(mask, 200, 200, 10, 10);
robot.mouseRelease({left: true}, 100);
duration便是的是执行这个动作所需要的时间，以typeKeys为例，假设duration设置为1800ms，char为“abc”，则输入a、b、c这三个字符各占600ms。
2、mouseMoveAt
dojo/Robot中提供了一个mouseMoveAt函数，在上文的示例中，我们可以看到鼠标移动函数用的是mouseMove函数，该函数与mouseMoveto函数都是通过相对于当前浏览器document的x、y坐标来定位元素，而mouseMoveAt则是通过选择符或者node节点来定位元素。
mouseMoveAt : function(/*String||DOMNode||Function*/ node, /*Integer, optional*/ delay, /*Integer, optional*/ duration, /*Number, optional*/ offsetX, /*Number, optional*/ offsetY){
// summary:
// Moves the mouse over the specified node at the specified relative x,y offset.
//
// description:
// Moves the mouse over the specified node at the specified relative x,y offset.
// You should manually scroll off-screen nodes into view; use dijit.robot for automatic scrolling support.
// If you do not specify an offset, mouseMove will default to move to the middle of the node.
// Example: to move the mouse over a ComboBox's down arrow node, call doh.mouseMoveAt(dijit.byId('setvaluetest').downArrowNode);
//
// node:
// The id of the node, or the node itself, to move the mouse to.
// If you pass an id or a function that returns a node, the node will not be evaluated until the movement executes.
// This is useful if you need to move the mouse to an node that is not yet present.
//
// delay:
// Delay, in milliseconds, to wait before firing.
// The delay is a delta with respect to the previous automation call.
// For example, the following code ends after 600ms:
// doh.mouseClick({left:true}, 100) // first call; wait 100ms
// doh.typeKeys("dij", 500) // 500ms AFTER previous call; 600ms in all
//
// duration:
// Approximate time Robot will spend moving the mouse.
// The default is 100ms.
//
// offsetX:
// x offset relative to the node, in pixels, to move the mouse. The default is half the node's width.
//
// offsetY:
// y offset relative to the node, in pixels, to move the mouse. The default is half the node's height.
//
所以上文中的实例可以这样写：
require(["doh/runner", "dojo/robot"], function(doh, robot){
doh.register("doh/robot",
{
name: "dojorobot1",
timeout: 6900,
setUp: function(){
document.getElementById('textbox').value="hi";
},
runTest: function(){
var d = new doh.Deferred();
robot.mouseMoveAt(document.getElementById('textbox'), 500);
robot.mouseClick({left:true}, 500);
robot.typeKeys(" again", 500, 2500);
robot.sequence(d.getTestCallback(function(){
doh.is("hi again", document.getElementById('textbox').value);
}), 900);
return d;
}
});
doh.run();
});
3、initRobot
对于WebAPP来说，都需要将测试代码与主程序代码分离。但测试文件执行时需要与主程序中的UI交互，这时轮到initRobot闪亮登场了。该函数位于dojox/Robot中，所以我们需要引入dojox/Robot。initRobot主要的作用就在于将当前测试文件的执行环境转变为主程序环境，这时robot.doc、robot.window代表的则是主程序中的document和window。比如说你想使用document.getElementById(‘login')来获取主程序中的login元素，那么你需要这样来写robot.doc.getElementById('login')，官方文档中提到使用dojo模块中的方法的执行环境都是主程序环境，遗憾的是我在实际使用中发现并非如此，有的模块方法的确是主程序环境比如query，而有的则并非主程序环境比如registry。
具体示例可以访问这里，查看源码你会发现这里面并没有robot的测试代码，该文件位于dojo-release-1.9.1-src\dijit\tests目录下，robot测试代码位于dojo-release-1.9.1-src\dijit\tests\robot目录下。
参考文档：https://dojotoolkit.org/reference-guide/1.9/util/dohrobot.html#doh-robot
下一篇我们将具体看一个完整robot示例，以及将robot与selenium联合使用进而将他与CI工具集成。同时我们还会讨论robot异步函数的美中不足。