WebKit自动化回归测试之LayoutTest实践 (超时有关问题的处理) _Web前端

WebKit自动化回归测试之LayoutTest实践 (超时问题的处理)

转载请注明出处:http://blog.csdn.net/horkychen

WebKit的回归测试是由一组脚本构成的Layout Tests，测试内容是测试的网页和标准结果(Baseline)。其测试脚本执行的基本方式示意如下:

*脚本会启动http服务器以支持网页加载,在此不做描述。

而每个网页里面都含有测试用的JavaScript脚本, 主要因为有一些DOM对象被动态注入了供JavaScript脚本使用。(关于如何添加这个DOM对象，可以参考这篇文章的第二种情况。代码在WebCoreTestSupport.cpp::injectInternalsObject()) 。这些对象中就是testRunner、eventSender、GCController、textInputController、internals。它们的功能是和DumpRenderTree交互。可以交互的内容列在这里了:

Write Layout Tests for DumpRenderTree

测试脚本其实就是JavaScript脚本加上这些新对象。需要注意在使用这些对象前最好检查一下，保持一个兼容性，如官网给的例子:

if (window.testRunner)

{

testRunner.dumpAsText(true);

}

……

使用WebKit提供的脚本就可以开始测试了: (以下是在WebKit目录下执行)

Tools/Scripts/run-webkit-tests --verbose --debug [目标目录]

*更多选项，使用Tools/Scripts/run-webkit-tests --help可以看到。

下面讲一个实作，中间要解决一个关于时间控制的问题。

先架环境，下载了Webkit后，还需要从Webkit的代码库中导出LayoutTest。在WebKit目录执行:

svn export http://svn.webkit.org/repository/webkit/trunk/LayoutTests/ LayoutTests

等吧！有1.5G之大，我可是下了两天。

说明一下测试目标。测试一下JS Engine对时间控制的准确性。写了一段JS脚本，会每隔两秒输出当前时间及与上次的时间差。所以Document加载完成后，脚本还需要运行一段时间。好在testRunner提供waitUntilDone和notifyDone可以使用。waitUntilDone表示测试程序要等待脚本发送notifyDone才表示测试用例执行结束，然后才能收集结果。否则DumpRenderTree当网页加载完成后，就后直接Dump，然后走人，而这个时候，这个测试脚本还什么都没发生呢。

测试的网页如下:

<html>
<head>

</head>

<body>

    <div id="dd"></div>


    <script>
    if (window.testRunner)
    {
    testRunner.dumpAsText(true);
    }
    
totalCount = 20;
        text = "";
        nOld= -1;
        var handle;

        function repaint()
        {
            var now = new Date();
            
             str = "<b>" + now + "</b>####" ;
            
            if(-1==nOld)
            {
            nOld=now.getTime();
            str+= "  <span style=\"color:#0000FF;\"]] > Begin</span><div />"
            }
            else
            {
            nDiff = now.getTime()-nOld;
            if(  Math.abs(nDiff-2000) >=5 )
            {
            str+= "<span style=\"color:#FF0000;\"]]
>
NG ("+nDiff+")</span><div />"
            }
            else
            {
              str+= "<span style=\"color:#0000FF;\"]] > OK</span><div />"
            }
            nOld=now.getTime();
            }
            
            text = str + text;
            document.getElementById('dd').innerHTML = text;
            
            totalCount--;
            
            if( 0 == totalCount )
            {
            	clearInterval(handle);
            	if (window.testRunner) 
            	{
    			testRunner.notifyDone();
    	     	}
            }
        }   

        handle = setInterval(repaint, 2000);
        
        if (window.testRunner)
        {
        testRunner.waitUntilDone(); //Ask testRunner to wait the script done.
        }

    </script>

</body>

</html>

然后把脚本放到LayoutTests目录下:

执行Tools/Scripts/run-webkit-tests脚本，指定运行脚本的目录就可以了。不幸的是出错了。

看到是Time-Out的问题(脚本执行时加上--verbose可以看到更多的细节),前面的测试脚本会运行至少20*2s, 也就是至少需要40秒的时间。而run-webkit-tests默认的时间为35s (执行时脚本也有输出)，所以超时了。喜欢探究一下的，可以看看Scripts/webkitpy/layout_tests/controllers/manager.py。

run-webkit-tests提供了一个参数可以指定自己的TimeOut设定。

--time-out-ms=TIME_OUT_MS (针对所有测试用例)

将Time-Out时间设为70秒再试一次：

Tools/Scripts/run-webkit-tests --verbose --debug --no-build --no-retry --time-out-ms=70000 xxxxx

结果仍然出错了。真正的问题来了。

这里关于分析过程省略500字……

最终发现, DumpRenderTree还有一个对于waitUntilDone/notifyDone的限定。默认在收到waitUntilDone后，超过30秒没有接到notifyDone，就算超时。相关代码都在DumpRenderTree工程中：

Mac OS LayoutTestControllerMac.mm ->waitToDumpWatchdogInterval赋值

Windows TestShell.cpp -> 建构函数

所以这里有两个Time-Out时间，一个是控制每个测试用例的运行时间，另一个是waitUntilDone等多久的时间。示意如下:

两个一组合，这个测试还是没过。而且后者在Mac OS的实现(Windows有入口可以改掉)是Hard Code没办法通过参数设置。我们只能强行改掉它了，关于这个问题我正在联系WebKit确认准备提交个Bug。

注意，改完后，要使用Tools/Scripts/build-dumprendertree来重新编译。在run-webkit-tests加--build帮不上你的。

然后再执行一次上面的脚本，就可以看到正常的结果了。测试的结果会被存储在与DumpRenderTree同级目录下:

*xxx-actual.txt -> 为实际dump出来的结果

*xxx-diff.txt ->差异比对结果

*xxx-expected.txt -> 标准输出

*xxx-stderr.txt -> 运行过程中的错误信息输出

另一种方案，修改layouttest脚本给DumpRenderTree加个--no-timeout使得每个Case几乎不用考虑超时的问题。这样做，风险就太高了，很可能卡死在某个测试用例。

Reference:

http://www.webkit.org/blog/1456/layout-tests-practice/

http://trac.webkit.org/wiki/Writing%20Reftests