接口自动化测试平台FasterRunner系列（二）- 功能模块

接口自动化测试平台FasterRunner系列（二）

功能模块

目录

• 1、首页
• 2、项目概况
• 3、API模板
  • 3.1、分组
  • 3.2、接口
    • 3.2.1、Header
    • 3.2.2、Request
    • 3.2.3、Extract
    • 3.2.4、Validate
    • 3.2.5、Variables
    • 3.2.6、Hooks
  • 3.3、运行
    • 3.3.1、单接口运行
    • 3.3.2、指定组运行
• 4、测试用例
  • 4.1、分组
  • 4.2、用例集
  • 4.3、运行
    • 4.3.1、用例集运行
    • 4.3.2、指定组运行
• 5、配置管理
  • 5.1、Header
  • 5.2、Request
  • 5.3、Variables
  • 5.4、Hooks
  • 5.5、Parameters
• 6、全局变量
• 7、域名管理
• 8、驱动代码
• 9、定时任务
• 10、历史报告

1、首页

使用已注册用户admin进行登录，登录后默认跳转到首页。

左侧为菜单栏，右侧显示项目名称、负责人、项目描述、更新时间。可进行添加、查看、编辑、删除项目。

注：删除操作会强制删除该项目下所有数据，请谨慎操作。

点击指定项目的详情，会跳转到项目概况页。

2、项目概况

项目概况页详细列出当前项目的一些信息。

如图所示：已有4个接口、1个用例集、1套配置、1对变量、1套环境、1项任务、51个报告。

3、API模板

3.1、分组

先进行新建分组（其实就是模块），可对创建后的分组进行删除、重命名等操作。分组下还可以创建子分组。在指定的组上创建接口，之后对接口信息进行维护。

注：删除操作会强制删除该分组下所有数据，请谨慎操作。

如图所示：创建组module 1，module 1上已经创建4个接口。

3.2、接口

点击添加接口，输入接口名称、请求方法（支持POST、GET、PUT、DELETE等）、请求地址等信息，执行时，可以设置迭代次数，默认为1次。

对于已创建完成的接口，可进行修改、命名、运行、删除操作。

3.2.1、Header

请求头

3.2.2、Request

请求参数（对于POST方法，表单是指消息体是键值对表单，json是指消息体是json串；params是指用GET方法时带在URL后的参数）。

使用 变量名 的方式来引用其变量值。例如 username

使用 {函数名(参数1, 参数2, …)} 的方式来调用函数。例如 {get_userId()}

3.2.3、Extract

抽取接口返回值

完成请求后，从返回内容中抽取数据存入变量，在后面的请求中，可以通过引用该变量来获取该值。

假设返回json，那么就是content.key或者content.key.0.key形式（0是索引）。

抽取复杂返回值，例如：抽取content的dataList列表的首个元素的name字段是以字符串’.ABC’结尾的。content.dataList.0.name/endswith/(string)/’.ABC’

3.2.4、Validate

接口断言

可以引用Extract里的，也可以直接抽取。

使用 变量名 的方式来引用其变量值。例如 username

使用 {函数名(参数1, 参数2, …)} 的方式来调用函数。例如 {get_userId()}

3.2.5、Variables

局部变量

只在当前用例有效。可以给Request、Validate，通过 $变量名 方式引用即可。

3.2.6、Hooks

hook机制

（1）测试之前执行的方法：在HTTP请求发送前执行hook机制，主要用于准备工作；也可以实现对请求的Request内容进行预处理。

（2）测试之后执行的方法：在HTTP请求发送后执行hook机制，主要用于测试后的清理工作；也可以实现对响应的Response进行修改，例如进行加解密等处理。

使用 变量名 的方式来引用其变量值。例如 username

使用 {函数名(参数1, 参数2, …)} 的方式来调用函数。例如 {get_userId()}

3.3、运行

3.3.1、单接口运行

1、选择环境、选择配置、点击运行，进行指定接口的执行。

2、执行完成后，当前页面显示报告。

3、在“历史报告”下也会有此报告记录。

3.3.2、指定组运行

1、选择环境、选择配置、点击运行，之后选择同步执行或异步执行方式（异步支持自定义报告名称，默认时间戳命名），选择要运行的组，点击确定即可。

同步执行：是指在当前页等待用例执行完成后，当前页会自动弹出执行报告页面，在“历史报告”下也会有此报告记录。

异步执行：是指用例在后台执行，执行完报告不会主动显示到页面，只会保存在“历史报告”下，用户需自己查看。

2、报告效果：

（1）同步执行

报告类型为调试

（2）异步执行

报告类型为异步

第一个自定义报告名，第二个默认时间戳命名。

4、测试用例

4.1、分组

先进行创建分组（其实就是模块），可对创建后的分组进行删除、重命名等操作。

注：删除操作会强制删除该模块下所有数据，请谨慎操作。

如图所示：创建组TestSuite

4.2、用例集

1、点击添加用例，进行新增测试用例集操作，选择要执行的用例与配置，对已选中的用例可进行拖拽操作，可设置执行顺序（主要针对接口流程测试），最后保存即可。

2、可对新增的用例集进行修改、运行、命名、删除操作。

4.3、运行

4.3.1、用例集运行

1、点击运行，进行指定用例集的执行。

2、执行完成后，当前页面显示报告。同样在“历史报告”下也会有此报告记录。

4.3.2、指定组运行

运行指定的组，执行方式也是分为同步执行或异步执行（异步支持自定义报告名称，默认时间戳命名），选择要运行的组，点击确定即可。

同步执行：是指在当前页等待用例执行完成后，当前页会自动弹出执行报告页面，在“历史报告”下也会有此报告记录。

异步执行：是指用例在后台执行，执行完报告不会主动显示到页面，只会保存在“历史报告”下，用户需自己查看。

报告效果和在API模板按指定组运行方式一样。

5、配置管理

1、新增配置，可定义全局Hooks，公共Request参数和公共Header，一般可用于验证环境切换配置。

2、对已存在的配置，可进行修改、命名、删除操作。

5.1、Header

请求头

5.2、Request

请求参数（对于POST方法，表单是指消息体是键值对表单，json是指消息体是json串；params是指用GET方法时带在URL后的参数）。

使用 变量名 的方式来引用其变量值。例如 username

使用 {函数名(参数1, 参数2, …)} 的方式来调用函数。例如 {get_userId()}

5.3、Variables

局部变量

只在当前用例集有效。可以给Request、Validate，通过 $变量名 方式引用即可。

5.4、Hooks

hook机制

（1）测试之前执行的方法：在HTTP请求发送前执行hook机制，主要用于准备工作；也可以实现对请求的Request内容进行预处理。

（2）测试之后执行的方法：在HTTP请求发送后执行hook机制，主要用于测试后的清理工作；也可以实现对响应的Response进行修改，例如进行加解密等处理。

使用 变量名 的方式来引用其变量值。例如 username

使用 {函数名(参数1, 参数2, …)} 的方式来调用函数。例如 {get_userId()}

5.5、Parameters

参数列表

参数列表中放入该变量的多种可能的值，则这一个用例会自动使用这多个值分别执行一次。注意以下几点：

（1）对于同时存在多个参数列表，则需要对其排列组合的每一种情况都执行一次。

例如：

xx : [xxvalue1, xxvalue2]

yy : [yyvalue1, yyvalue2, yyvalue3]

会按以下六种情况各执行一次用例：

xx=xxvalue1, yy=yyvalue1

xx=xxvalue1, yy=yyvalue2

xx=xxvalue1, yy=yyvalue3

xx=xxvalue2, yy=yyvalue1

xx=xxvalue2, yy=yyvalue2

xx=xxvalue2, yy=yyvalue3

（2）对于参数间有对应关系的，可以按xx-yy: [xxvalue1-yyvaule1, xxvalue2-yyvalue2]的方式定义，只会执行两种情况，这样就避免了无效的排列组合：

xx=xxvalue1, yy=yyvalue1

xx=xxvalue2, yy=yyvalue2

在使用多个账户/密码进行测试时，常用这种方式。

6、全局变量

新增变量，定义为全局变量，方便用例或用例集引用。

并可对变量进行修改与删除操作。

7、域名管理

新增环境，定义域名。

并可对域名进行修改与删除操作。

8、驱动代码

自定义辅助函数，可以写一些Python脚本。

用于当前项目调用，还可以进行在线调试运行，运行日志信息可在调试控制台上打印出来。

调用函数的方法是 ${函数名(参数1, 参数2, …)}

如有个get_userId()函数，调用此函数方法是 ${get_userId()}

如有个get_userId(id)函数，参数id为变量，get_id可以获取id值，调用此函数方法是 {get_userId(

9、定时任务

点击添加任务，创建一个定时任务，添加用例集的定时任务，遵循crontab表达式，可设置将报告发送到指定邮箱里。

crontab示例：

10 * * * * 表示每X小时10分执行一次。

*/10 * * * * 表示每10分钟执行一次。

1、添加任务，输入配置信息。

2、选择指定的用例集，点击保存。

3、定时任务添加完成后。

4、按照定时执行规则，将测试报告发送到邮箱里。

5、在“历史报告”下，可以看到执行后的报告，报告类型为定时。

10、历史报告

可查看同步执行、异步执行和定时任务执行的报告，均会存储在数据库里，报告可以在线点击查看，也可进行删除、搜索操作。

打开报告显示效果（基于ExtentReports实现）。

原版背景色默认是白色，已自定义修改为默认是黑色。