yapi中的高级mock--期望

1. 功能

测试时,经常需要根据不同的请求参数和IP返回不同的HTTP 状态码、HTTP头、JSON数据等。期望就是根据设置的请求过滤规则返回期望数据。

2. 为接口添加期望

image
首先选中一个接口,点击“高级Mock”,再点击“添加期望”,可以看到类似下图的弹出窗口。

image

所填写的信息分为两部分:基本信息,响应。

2.1 基本信息

此处可以添加IP过滤规则和参数过滤规则。

  • 如果你添加了IP过滤,则意味着,只有使用此IP访问此mock接口,才会返回该期望的响应值。
  • 如果你添加了参数过滤,则意味着,访问此mock接口时,url参数中必须有sgid参数,才会返回该期望的响应值。
  • 如果添加了多个过滤条件,则多个条件必须同时满足方可生效。

上图中我们添加参数过滤规则:sgid,26。意味着访问mock接口时,url参数中必须有sgid=26(也可以有其它参数),才会返回该期望的响应值。比如:

http://localhost/mock/11/mrecharge/login?sgid=26&t=1549095317

2.2 响应

image
如上图所示,响应中有很多选项可以设置。

  • HTTP Code: http请求响应状态码。
  • 延时:给响应加延时,可以用来模拟接口响应慢或超时的情况。
  • HTTP头:添加任意符合http协议规范的响应头。
  • Body: 返回数据,可以是html, json等等任意字串。可以使用mockjs模板和占位符语法(详见第3节)。

按上图添加的响应,我们在浏览器中看到的返回值如下:
image

3. 模板与占位符

3.1 占位符

关于占位符,可以参看《yapi中使用json-schema mock数据》中的"3. 基于mockjs占位符的mock"。

3.2 模板

模板是生成数据的规范,mockjs中的模板定义及模板形式可以点击这里查看。期望中并不支持所有的模板形式,比如属性值是Function的形式就不支持。个别模板的形式略有不同,比如正则。

下面介绍两种平时比较常用到模板。

3.2.1 生成数组

1. “name|1”: array

从属性值 array 中随机选取 1 个元素,作为最终值。

2. “name|+1”: array

从属性值 array 中顺序选取 1 个元素,作为最终值。

3. “name|min-max”: array

通过重复属性值 array 生成一个新数组,重复次数大于等于 min,小于等于 max。

4. “name|count”: array

通过重复属性值 array 生成一个新数组,重复次数为 count。

例:

{
  "data|4": [
    {
      "name|+1": [
        "ball",
        "xuan",
        "moon",
        "elephant"
      ],
      "age": "@integer(10,20)",
      "fruit|1": [
        "apple",
        "banana",
        "peach",
        "pear"
      ]
    }
  ]
}

该模板生成包含4个元素的数组,每个元素中的name,顺序取名字列表中的一项,age取10~20的整数,fruit随机取水果列表中的一项。生成数剧类似:

{
	"data": [{
		"name": "ball",
		"age": 16,
		"fruit": "banana"
	}, {
		"name": "xuan",
		"age": 19,
		"fruit": "pear"
	}, {
		"name": "moon",
		"age": 13,
		"fruit": "peach"
	}, {
		"name": "elephant",
		"age": 19,
		"fruit": "pear"
	}]
}

注意对比"|1”与“|+1”的区别。个人感觉"|1"也可以考虑用占位符@pick实现。

3.3.2 使用正则表达式

“name|regexp”: 正则表达式

根据正则表达式反向生成可以匹配它的字符串。

例:

{
  "data|2-6": [
    {
      "orderid|regexp": "[A-Za-z0-9]{32}",
      "price": "@pick(10,20,50,100)",
      "phone|regexp": "^1[387][0-9]{9}$",
      "ctime": "@timestamp"
    }
  ]
}

该模板随机生成包含2-6条json形式的订单数据。数据中的订单号,手机号由正则生成。生成数据类似:

{
	"data": [{
		"orderid": "c06HPwunKn2bmg02Le2U1lXwiP4CFFt3",
		"price": 50,
		"phone": "18382571432",
		"ctime": 1549098973
	}, {
		"orderid": "GWLedowWqmb157db13eSIxSku1jiVu4h",
		"price": 20,
		"phone": "17296946507",
		"ctime": 1549098973
	}]
}

注意:正则中不支持诸如\d, \w, \S等写法。

猜你喜欢

转载自blog.csdn.net/qmhball/article/details/86750999