robotframework_sample_中文版

翻译部分：

2.2.1 测试用例语法

基本语法

测试用例是由测试用例表中有效的关键字构成的。关键字可以从测试函数库或资源文件中导入，也可以在测试用例文件中的关键字表里创建。

测试用例表的第一列为测试用例名。一个测试用例是从某一用例名开始直到下一个用例名出现或者表格已到末端为止的。表头和第一个测试用例之间不能存在任何东西，否则将被认为是错误的。

第二列通常存放的是关键字名。但存在一种特例即：存在变量接收关键字的返回值，当有一个变量或者多个变量用作接收关键字返回值时，关键字写在这些变量后面。不论何种情况，关键字名后面的列都会包含指定关键字合适的参数。

测试用例举例

************************************************************************

测试用例表设置

测试用例也可以拥有它们自己的设置。与关键字一样，设置名永远在第二列中，且它们的值会紧随在后续的列中。设置名都被方括号包围着，以区别开关键字。下面列出的是可用的设置名，将会在后面的章节进行解释。

[Documentation]

用于标明一个测试用例的文档

[Tags]

用于标记测试用例

[Setup], [Teardown]

指定测试的创建和销毁。和使用 [Precondition]和[Postcondition]效果相同。(synonyms的含义是同义词)

[Template]

用于指定模板关键字。这类测试本身将只包含所对应关键字的参数数据。

[Timeout]

用于设置测试用例超时。超时将会在其对应的章节中进行阐述。

包含设置的测试用例举例

************************************************************************ 在设置表中与测试用例相关的设置

设置表提供以下测试用例相关的设置项。这些测试用例相关的设置基本使用默认值。

Force Tags, Default Tags

标签的强制值和默认值

Test Setup, Test Teardown

测试安装和销毁的默认值，和使用test Precondition和test Postcondition作用相同

Test Template

默认的模板关键字

Test Timeout

测试用例超时的默认值，超时将会在其对应的章节中进行阐述。

2.2.2 使用参数

之前的例子已经表明关键字可以接收不同的参数，这部分将更彻底地讨论这个重要的功能。如何真正实现使用含不同参数的用户关键字和函数库关键字将在其它章节单独介绍。

关键字可以接受零个或多个参数，一些参数可能有自己默认的值。关键字接受哪种参数取决于其如何实现，寻找此信息最好的地方莫过于关键字注释文档。在本节的例子中，注释文档是由libdoc.Py这个工具生成的，然而相同的信息我们也可

以从类似的注释文档工具例如java doc中生成。

必选参数

大多数关键字通常都有确定数目的参数。在关键字注释文档中，它们是通过在指定的参数之间添加逗号来分隔开的(如 frist,second,third)。在这种情况下参数的名字并不重要，除非需要解释该参数的作用是什么，但重要的是必须保证其参数数目与注释文档中的数目保持一致。使用过少或者过多的参数都会导致错误的发生。

下面的用例从OperatingSystem函数库中调用了Create Directory 和Copy File

关键字，参数格式被规定为path和source， destination，这意味着它们分别带了一个参数和两个参数。而最后一个从BuiltIn库中调用的关键字No Operation，不带

任何参数。

************************************************************************

带有默认值的参数可以给出也可以不给出。本文档中，参数名和默认值有等号分隔，如name=default value，但是对于Java实现的关键字而言，一个关键字可能有多种实现方法，只是各个方法给出的参数不同。一般参数都可以给出默认值，但是带有默认值的参数后面不能再有确定位置的参数。(与Python不同，JAVA默认参数的实现需要用到重载机制：一个相同名字的函数，可以通过不同的参数个数区分。默认参数其实不体现在Java对应函数的参数列表中，而是在程序内实现，可

见这个例子，/blog/358512 ，这个讲起来有点儿啰嗦，不展开了，有兴趣的同学可以找我进一步讨论。)

下面举例说明如何使用默认值。这个例子使用Create Files关键字，关键字带

有参数path、content=、coding=UTF-8编码方式。(调用的时候)如果试图不带参数

或者参数超过三个，那么(此关键字方法)都不能成功调用。

************************************************************************

可变个数的参数

关键字可以接受任意个数的参数。参数可以由必须输入的参数和带有默认值的参数组成，但是所谓的可变参数一般要放在最后。通常文档会在这些参数名字前加一个*号，比如*varargs，以示区别。JAVA库的实现依然与之不同。

举例说明Remove Files 和Join Paths关键字分别带有*paths和base参数和

*parts参数。前者可带有任意数量参数，而后者则要求至少有一个参数。