引言:什么是RFS――RobotFramework+Selenium2library,本系列主要介绍web自动化验收测试方面。
( @齐涛-道长 新浪微博)
在我们做自动化案例的时候,用的最多的主要是用户关键字。说到关键字,大体上可以分为测试库关键字(或叫系统关键字)和用户关键字,前者一般都是通过加载Library得到的,而用户关键字一般都是通过加载Resouce得到的。
以之前的这个case为例:
图中的Import Variables和log都是测试库关键字,而搜索测试这个就是用户关键字,只要RIDE的版本高一些,就能看出他们的颜色是有区别的。
接下来,我们新建一个案例,并针对用户关键字的用法进行介绍。
1、先新建一个用户关键字,不用带arguments。
在Setting下面的这些呢,Documentation就不多说了。主要看下面4个设置,其实前面的文章里也简单介绍过,这里再说一下。
Arguments: 设置传入参数
Teardown: 设置完成时的动作,比如写上Close All Browsers,表示在这个用户关键字执行完成之后会执行什么关键字。
Timeout: 设置超时时间,如写上1min,表示1分钟超时,如果这个关键字执行超过1分钟则认为失败。
Return Value: 设置返回值
一直以来我都觉得用户关键字就像一个函数一样,有传入参数Arguments,有返回值Return Value,而且还可以用Teardown作为函数完成后的清理动作。
所以我们也要像函数一样来使用User Keyword。
2、传入参数Arguments
前面在做案例分层的时候其实已经用到了一些参数设置了,可以看看前面2篇文章。这里提一下多参数及可选参数的设置。
0)变量类型
顺带提一下变量的类型,RF里的变量分两种,一种是Scalar,可以理解为单值变量,一种是List Variable,list型变量,或者可以理解为数组变量。Scalar型变量用$符号开头,List型变量用@符号开头。这里只是简单介绍,后面会专门写一篇两种变量关系的。
1)必填参数
给我们的关键字先添加4个参数,参数之间使用 | 进行分隔。(如果想在默认值里使用 | 作为一个值而不是分隔符,那么就要使用 \| 来表示|的值。
如果是这样添加参数呢,表示这些参数都是必填的,我们建一个case3,并调用关键字测试看一下,这里的关键字测试后面的4个格子都是红色,提示参数必填。
2)选填参数
假设我们想把其中第2个参数设成选填参数,选填参数就是给参数加上默认值,默认值使用 = 加上值,如果想默认为空,只写等号就行了。
(默认值的意思不需要细讲了哈,就是如果你在调用这个关键字的时候,如果不给这个选填参数传值,那么就使用默认值作为参数的值)
如果我们直接这样加的话,点击OK就会报错。意思是说必填参数不允许在选填参数后面。
也就是说如果某一个参数设置成了选填参数,那么他后面的参数都必须是选填参数,不能是必填参数。
在我们这里就是第2个参数如果要可选,要么把3、4参数也都设置上默认值,要么就把第2个参数调整到最后去。我先调整成下面这样,就不会报错了。
3)List变量参数
List变量也是可以作为参数,但是List变量只能放在最后一位。如果放在前面,就会报错。
我把arg4改成了@{arg4}这样的List变量,保存时就会提示List变量只能作为最后一个参数。
为啥只能是最后一个呢?从英文的角度看是the last argument,没有s。。。。
如果一定要试试最后2个都放list变量呢,也是会报错的。
这是为什么呢?首先,List变量本来来说,他是一个可变的,即List的成员数量不确定。而List作为参数的话,有几个成员就是相当于几个单值参数,他实际上是提供了一种参数个数可变的方式。那么既然可变,如果放在前面的话(见第一个例子的图),他就没法确定传入的参数到底哪些是给arg4的,哪个是给arg2的了;同理,如果放2个List也是不行的(见第二个例子的图),因为也是无法区分传入的参数到底哪些是给arg4,哪些是给arg2。
而且2个可变和1个可变没什么差别滴,所以最终限定是只能有1个List参数,并且必须放在最后。
注意一下:变量名和等号间不能有空格,如果有空格系统会报参数语法错误。
最后看一下List参数的实例,其他几种实例应该没什么复杂的,大家自己练习一下即可。
为了看的方便,我把参数数量减少点,只放2个参数,${arg1} | @{arg2},然后用了个Fail,目的是想把值打印在运行界面上。
然后我们在case3里给他传几个值。
我特意把关键字的说明也截图下来,大家可以看到agr2前面有个*,表示他可以接受任意个参数,Python里其实也是这样处理多参数的。
运行一下案例,看一下打印出来的内容。
好了,这一篇就先介绍到这里,我们把传入参数的部分详细介绍了一下,我做的例子只是简单基础的例子,大家可以根据自己的需要进行发挥。
下一篇会继续介绍User Keyword里面的Teardown和Return Value的内容,预计今晚或明天~