1 关联参数
如果进行测试的2个接口中,第2个接口需要使用第一个接口返回的参数,在 HttpRunner 中,支持参数提取(extract)和参数引用的功能($var)。
extract 的列表中可指定一个或多个需要提取的参数。
在提取参数时,当 HTTP 的请求响应结果为 JSON 格式,则可以采用.运算符的方式,逐级往下获取到参数值;响应结果的整体内容引用方式为 content 或者 body。
例如,第一个接口/api/get-token的响应结果为:
{"success": true, "token":"ZQkYhbaQ6q8UFFNE"}
那么要获取到 token 参数,就可以使用 content.token 的方式;具体的写法如下:
"extract": [{"token":"content.token"}]
其中,token 作为提取后的参数名称,可以在后续使用 $token 进行引用。
"headers": {
"device_sn": "FwgRiO7CNA50DSU",
"token":"$token",
"Content-Type": "application/json"
}
2 变量的申明和引用
为了更好地维护测试用例,例如同一个参数值在测试步骤中出现多次,那么比较好的做法是,将这些参数定义为变量,然后在需要参数的地方进行引用。
在 HttpRunner 中,支持变量申明(variables)和引用($var)的机制。在 config 和 teststeps 中均可以通过 variables 关键字定义变量,然后在teststeps中可以通过 $ + 变量名称的方式引用变量。区别在于,在 config 中定义的变量为全局的,整个测试用例(testcase)的所有地方均可以引用;在 teststeps 中定义的变量作用域仅局限于当前teststeps。示例:
3 实现动态运算逻辑
HttpRunner 的测试用例都是采用 YAML/JSON 格式进行描述的,在文本格式中如何执行代码运算呢?
HttpRunner 的实现方式为,支持热加载的插件机制(debugtalk.py),可以在 YAML/JSON 中调用 Python 函数。
具体地做法,我们可以在测试用例文件的同级或其父级目录中创建一个 debugtalk.py 文件,然后在其中定义相关的函数和变量。
例如,针对 device_sn 的随机字符串生成功能,我们可以定义一个gen_random_string 函数;针对 sign 的签名算法,我们可以定义一个 get_sign 函数。
importhashlib
importhmac
importrandom
importstring
SECRET_KEY="DebugTalk"
defgen_random_string(str_len):
random_char_list=[]
for_inrange(str_len):
random_char=random.choice(string.ascii_letters+string.digits)
random_char_list.append(random_char)
random_string=''.join(random_char_list)
returnrandom_string
defget_sign(*args):
content=''.join(args).encode('ascii')
sign_key=SECRET_KEY.encode('ascii')
sign=hmac.new(sign_key,content,hashlib.sha1).hexdigest()
returnsign
然后,我们在 YAML/JSON 测试用例文件中,就可以对定义的函数进行调用,对定义的变量进行引用了。引用变量的方式仍然与前面讲的一样,采用$ + 变量名称的方式;调用函数的方式为${func($var)}。
例如,生成 15 位长度的随机字符串并赋值给 device_sn 的代码为:
"variables":[
{"device_sn":"${gen_random_string(15)}"}
]
使用$user_agent、$device_sn、$os_platform、$app_version 根据签名算法生成 sign 值的代码为:
"json":{
"sign":"${get_sign($user_agent, $device_sn, $os_platform, $app_version)}"
}
4 参数化数据驱动
在 HttpRunner 中,若要采用数据驱动的方式来运行测试用例,需要创建一个文件,对测试用例进行引用,并使用parameters 关键字定义参数并指定数据源取值方式。
例如,我们需要在创建用户的接口中对 user_id 进行参数化,参数化列表为 1001~1004,并且取值方式为顺序取值,那么最简单的描述方式就是直接指定参数列表,内容如下所示:
config:
name:testcase description
teststeps:
create user:
testcase:demo-quickstart-6.yml
parameters:
user_id:[1001,1002,1003,1004]
仅需如上配置,针对 user_id 的参数化数据驱动就完成了