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等写法。