提示:当用户关键字使用命名参数语法时,参数名不能使用${}。例如,用户关键字${arg1}=default, ${arg2}=second必须写作arg2=override。
命名参数语法仅用参数等号前的部分和一个带默认值的参数名相匹配时。这种匹配从给定的参数列表末尾开始直到没有可匹配参数为止。在一些极少数特例中,可以使用“\”规避这种语法,例如nomatch\=here。
提示:命名参数语法对大小写和空格均敏感。前者意味着如果定义一个参数arg,必须写作arg=,Arg= 和ARG=都是不可行的。后者意味着在等号前不能有空格,等号后的空格将被视作默认值的一部分处理。
下面的例子展示了命名参数语法在包括引入测试库等不同场景下的使用方法:
命名参数示例
Setting |
Value |
Value |
Value |
Library |
Telnet |
prompt=$ |
Test Case |
Action |
Argument |
Argument |
Argument |
Example |
Open connection |
10.0.0.42 |
port=${25} |
|
List files |
options=-lh |
|||
List files |
path=/tmp |
options=-l |
Keyword |
Action |
Argument |
Argument |
Argument |
List files |
[Arguments] |
${path}=. |
${options}= |
|
Execute command |
ls ${options} ${path} |
嵌入参数的关键字名
另一种完全不同的定义参数的方法是将参数嵌入关键字名。这种语法目前为止只支持用户关键字。
2.2.3 用例名称和文档
测试用例名直接来自于测试用例表:它就是我们在测试用例列里直接输入的内容。测试套件里的测试用例应该有唯一的名称。关于这一点,你也可以用automatic variable的${Test_Name}来指明其测试名称。不管什么时候执行用例都可以这样使用,,包括所有的用户级关键字、测试(setup)装载和测试销毁(teardown)。
Documentation设置允许你可以为测试用例设置自由文本说明。这些文字说明可以显示在命令行输出、测试日志和测试报告中。如果文本说明太长,可以将其拆分到几个单元格中,,文本中间用空格进行连接。可以使用简单的html 格式 和变量,以文档变得更加生动。从Robot Framework 2.1开始,文档中一些不存在的变量被不做改变的直接记录下来。
测试用例文档例子 |
|||
Test Case |
Action |
Argument |
Argument |
Simple |
[Documentation] |
Simple documentation |
|
|
No Operation |
|
|
Splitting |
[Documentation] |
This documentation is a bit longer and |
it has been split into several columns. |
|
No Operation |
|
|
Formatting |
[Documentation] |
*This is bold*, _this italic_ and |
here is a link: http://robotframework.org |
|
No Operation |
|
|
Variables |
[Documentation] |
Executed at ${HOST} by ${USER} |
|
|
No Operation |
|
|