2.5 接口自动化用例高级配置
2.5.1 接口自动化用例内置函数
2.5.1.1 二元加法运算
函数名
$add(intA, intB)
功能说明
● 请求体
如下图所示，请求体中应用了二元加法运算函数，函数中的参数A为二元乘法运算
“$multiply(100,100)”、参数B为二元除法运算“$devide(1000,100)”。
● 检查点属性
如下图所示，检查点属性“result”的目标值为二元加法运算函数，函数中的参数 A为局部参数“test”，参数B为“1”。局部参数的设置方式请参考局部参数。
● if判断
如下图所示，if判断的目标值为二元加法运算函数，函数中的参数A为数字
“1”，参数B为环境变量“status”。环境参数的设置方式请参考设置环境参 数。
● for循环中断条件
如下图所示，for循环中断条件的目标值为二元加法运算函数，函数中的参数A、B 均为“1000”。
2.5.1.2 二元减法运算 函数名
$subtract(intA, intB)
功能说明
实现参数A与参数B的减法运算。其中，参数A、B支持以下类型：
● 数字
● 环境参数
● 局部参数
● 二元运算
使用场景
接口自动化用例中支持在以下场景中使用二元减法运算函数：
● 请求url路径
● 请求头
● 请求体
● 检查点属性
● if判断
● for循环中断条件
示例
● 请求url路径
如下图所示，请求url路径中参数“test”的值为二元减法运算函数，函数中的参 数A为“1001”、参数B为“1000”。
● 请求头
如下图所示，请求头中参数“subtract”的值为二元减法运算函数，函数中的参数 A为二元乘法运算“$multiply(100,100)”、参数B为“-1”。
● 请求体
如下图所示，请求体中应用了二元减法运算函数，函数中的参数A二元除法运算
“$devide(1000,100)”，参数B为二元加法运算“$add(1000,1000)”。
● 检查点属性
如下图所示，检查点属性“result”的目标值为二元减法运算函数，函数中的参数 A为局部参数“test”，参数B为“1”。局部参数的设置方式请参考局部参数。
● if判断
如下图所示，if判断的目标值为二元减法运算函数，函数中的参数A为数字
“1001”，参数B为环境变量“status”。环境参数的设置方式请参考设置环境参 数。
● for循环中断条件
如下图所示，for循环中断条件的目标值为二元减法运算函数，函数中的参数A为
“1001”、参数B为“1000”。
2.5.1.3 二元乘法运算
函数名
$multiply(intA, intB)
功能说明
实现参数A与参数B的乘法运算。其中，参数A、B支持以下类型：
● 数字
● 环境参数
● 局部参数
● 二元运算
使用场景
接口自动化用例中支持在以下场景中使用二元乘法运算函数：
● 请求url路径
● 请求头
● 请求体
● 检查点属性
● if判断
● for循环中断条件
示例
● 请求url路径
如下图所示，请求url路径中参数“test”的值为二元乘法运算函数，函数中的参 数A、B均为“100”。
● 请求头
如下图所示，请求头中参数“add”的值为二元乘法运算函数，函数中的参数A为 二元除法运算“$devide(1000,100)”、参数B为“-1”。
● 请求体
如下图所示，请求体中应用了二元乘法运算函数，函数中的参数A为二元加法运算
“$add(1000,1000)”、参数B为二元减法运算“$subtract(1001,1000)”。
● 检查点属性
如下图所示，检查点属性“result”的目标值为二元乘法运算函数，函数中的参数 A为局部参数“test”，参数B为“1”。局部参数的设置方式请参考局部参数。
● if判断
如下图所示，if判断的目标值为二元乘法运算函数，函数中的参数A为数字
“100”，参数B为环境变量“status”。环境参数的设置方式请参考设置环境参 数。
● for循环中断条件
如下图所示，for循环中断条件的目标值为二元乘法运算函数，函数中的参数A、B 均为“100”。
2.5.1.4 二元除法运算
函数名
$divide(intA, intB)
功能说明
实现参数A与参数B的除法运算。其中，参数A、B支持以下类型：
● 数字
● 环境参数
● 局部参数
● 二元运算
使用场景
接口自动化用例中支持在以下场景中使用二元除法运算函数：
● 请求url路径
● 请求头
● 请求体
● 检查点属性
● if判断
● for循环中断条件
示例
● 请求url路径
如下图所示，请求url路径中参数“test”的值为二元除法运算函数，函数中的参 数A为“1000”、参数B为“100”。
● 请求头
如下图所示，请求头中参数“divide”的值为二元除法运算函数，函数中的参数A 为二元加法运算“$add(1000,1000)”、参数B为“-1”。
● 请求体
如下图所示，请求体中应用了二元除法运算函数，函数中的参数A为二元减法运算
“$substract(1001,1000)”、参数B为二元乘法运算“$multiply(100,100)”。
● 检查点属性
如下图所示，检查点属性“result”的目标值为二元除法运算函数，函数中的参数 A为局部参数“test”，参数B为“1”。局部参数的设置方式请参考局部参数。
● if判断
如下图所示，if判断的目标值为二元除法运算函数，函数中的参数A为数字
“1”，参数B为环境变量“status”。环境参数的设置方式请参考设置环境参 数。
● for循环中断条件
如下图所示，for循环中断条件的目标值为二元除法运算函数，函数中的参数A为
“1000”、参数B为“100”。
2.5.1.5 获取当前时间戳
函数名
$timestamp()
功能说明
获取从格林威治时间1970年01月01日00时00分00秒（即北京时间1970年01月01日08 时00分00秒）起到当前时间的总毫秒数。
使用场景
接口自动化用例中支持在以下使用场景使用获取当前时间戳函数：
● 请求url路径
● 请求头
● 请求体
● 检查点属性
● if判断
● for循环中断条件
示例
● 请求url路径
如下图所示，请求url路径中参数“test”的值为生成当前时间戳函数。
● 请求头
如下图所示，请求头中参数“time”的值为生成当前时间戳函数。
● 请求体
如下图所示，请求体中应用了生成当前时间戳函数。
● 检查点属性
如下图所示，检查点属性“result”的目标值为生成当前时间戳函数。
● if判断
如下图所示，if判断的目标值为生成当前时间戳函数。
● for循环中断条件
如下图所示，for循环中断条件的目标值为生成当前时间戳函数。
2.5.1.6 获取指定时间戳
函数名
$getTimeBeforeHour(doubleA)
功能说明
获取当前时间之前A小时的时间戳。时间戳是指从格林威治时间1970年01月01日00时 00分00秒（即北京时间1970年01月01日08时00分00秒）起到指定时间的总毫秒数。
函数中的参数A支持以下类型：
● 数字
● 环境参数
● 局部参数
● 其它内置函数
使用场景
接口自动化用例中支持在以下使用场景使用获取指定时间戳函数：
● 请求url路径
● 请求头
● 请求体
● 检查点属性
● if判断
● for循环中断条件
示例
● 请求url路径
如下图所示，请求url路径中参数“test”的值为获取指定时间戳函数，函数中的 参数A为数字“3”。
● 请求头
如下图所示，请求头中参数“time”的值为获取指定时间戳函数，函数中的参数A 为数字“3”。
● 请求体
如下图所示，请求体中应用了获取指定时间戳函数，函数中的参数A为二元加法运 算“$add(2,2)”。
● 检查点属性
如下图所示，检查点属性“result”的目标值为获取指定时间戳函数，函数中的参 数A为局部参数“test”。局部参数的设置方式请参考局部参数。
● if判断
$dateFormat(String A)
参数说明
String A：日期时间值，支持以下几种格式：
● yyyy-MM-dd HH:mm:ss或MM-dd-yyyy HH:mm:ss格式。
● yyyy MM dd HH:mm:ss或MM dd yyyy HH:mm:ss格式。
● yyyy.MM.dd HH:mm:ss或MM.dd.yyyy HH:mm:ss格式。
● yyyy/MM/dd HH:mm:ss或MM/dd/yyyy HH:mm:ss格式。
功能说明
● 检查点属性
● if判断
● for循环中断条件
示例
● 请求url路径
如下图所示，请求url路径中参数“test”的值为日期转时间戳函数，函数中的参 数A为环境参数“date”。环境参数的设置方式请参考设置环境参数。
● 请求头
如下图所示，请求头中参数“date”的值为日期转时间戳函数，函数中的参数A为 环境参数“date”。
● 请求体
如下图所示，请求体中应用了日期转时间戳函数，函数中的参数A为
“2020-09-11 11:00:00”。
● 检查点属性
如下图所示，检查点属性“result”的目标值为日期转时间戳函数，函数中的参数 A为环境参数“test”。局部参数的设置方式请参考局部参数。
● if判断
如下图所示，if判断的目标值为日期转时间戳函数，函数中的参数A为
“2020-09-11 11:00:00”。
● for循环中断条件
如下图所示，for循环中断条件的目标值为日期转时间戳函数，函数中的参数A为
“2020-09-11 11:00:00”。
2.5.1.8 时间戳转日期
函数名
$timestamp_format(String A, String B)
参数说明
● String A：要转化的时间戳，20位以内的纯数字串，也可使用内置获取当前时间 戳函数$timestamp()。
2. H、m、s中若有一个为0位时，其它两个也必须为0位。
日期时间值中，连接符允许使用空格，“-”、“/”、“:”，也可以不使用连接 符。例如如下格式（包括但不限于）：
– yyyy-MM-dd HH:mm:ss – yyyyMMddHHmmss – yyyyMMddHHmmssSSS – yyyy-M-d H:m:s
– MM-dd-yyyy HH:mm:ss – MM/dd/yyyy HH/mm/ss – MM/d/yyyy H/mm/ss – MM/d/yyyy H/mm/ss SSS – yyyyMMdd SSS
功能说明
使用方式请参考获取当前时间戳，参数B为“yyyy-MM-dd HH:mm:ss”。● 请求头
如下图所示，请求头中参数“date”的值为时间戳转日期函数，函数中的参数A为 环境参数“date”，参数B为“yyyyMMddHHmmss”。环境参数的设置方式请参 考设置环境参数。
● 请求体
如下图所示，请求体中应用了时间戳转日期函数，函数中的参数A为
“123456789”，参数B为“yyyyMMddHHmmssSSS”。
● 检查点属性
如下图所示，检查点属性“result”的目标值为时间戳转日期函数，函数中的参数 A为内置获取当前时间戳函数“$timestamp()”，参数B为“MM/dd/yyyy
HH/mm/ss”。
● if判断
如下图所示，if判断的目标值为时间戳转日期函数，函数中的参数A为内置获取当 前时间戳函数“$timestamp()”，参数B为“MM/d/yyyy H/mm/ss SSS”。
● for循环中断条件
如下图所示，for循环中断条件的目标值为时间戳转日期函数，函数中的参数A为 内置获取当前时间戳函数“$timestamp()”，参数B为“yyyyMMdd SSS”。
2.5.1.9 时间戳加减运算
函数名
$timeStampCalculation(longA, StringB)
参数说明
● longA：毫秒级时间戳。
● StringB：时间差，integer范围内的数字加字母（天d/小时h/秒s），例如1d代表 对指定时间戳加一天，-1d代表对指定时间戳减一天。
功能说明
实现long型参数A与字符串参数B的加减运算，其中参数A、B支持以下类型：
● 符合参数说明格式的值
● 环境参数
● 局部参数
● 其它内置函数
使用场景
接口自动化用例中支持在以下场景中使用时间戳加减运算：
● 请求url路径
● 请求头
● 请求体
● 检查点属性
● if判断
● for循环中断条件
示例
● 请求url路径
如下图所示，请求url路径中参数“test”的值为时间戳加减运算函数，函数中的 参数A为“1607939485441”、参数B为“1d”。
● 请求头
如下图所示，请求头中参数“time”的值为时间戳加减运算函数，函数中的参数A 为日期转时间戳函数“$dateFormat(2020.09.11 11:00:00)”、参数B为
“-86400s”。
● 请求体
如下图所示，请求体中应用了时间戳加减运算函数，函数中的参数A为日期转时间 戳函数“$dateFormat(2020.09.11 11:00:00)”、参数B为“1d”。
● 检查点属性
如下图所示，检查点属性“result”的目标值为时间戳加减运算函数，函数中的参 数A为环境参数“time”、参数B为“-24h”。环境参数的设置方式请参考设置环 境参数。
● if判断
如下图所示，if判断的目标值为时间戳加减运算函数，函数中的参数A为环境变量
如下图所示，if判断的目标值为时间戳加减运算函数，函数中的参数A为环境变量