测试检查点

设置建议

• 推荐用户设置检查点。针对接口类请求，请提供判断响应码的检查点。
• 当检查点设置为空，不论接口的响应码是什么，都会判断结果为成功。

检查点说明

测试检查点即请求结果的断言，通过检查接口响应是否符合预期，判定系统是否满足预期。

在接口自动化用例中，测试步骤的“检查点”页签中可以定义测试检查点。

检查点内容包括属性、比较符和目标值定义。

例如，检查响应体（JSON格式）中“item.name”字段的第零位（首位）到第四位之间是不是petty，参数配置如下：

比较符说明

支持以下比较类型：

响应码检查

将响应码与目标值进行比较，例如：检查响应码是否等于“200”。

响应头检查

响应头中字段的值和目标值进行比较，例如：检查响应头中“content-type”的值是否等于“text/plain;charset=UTF-8”。

响应体（JSON）检查

1. 检查响应体（JSON）中对象字段的值。例如：

   响应体结构如下：

   

   检查响应体对象中字段名为“status”的值，检查点配置如下：

   

2. 检查响应体（JSON）中某个数组的对象的字段值（数组条件采用下标确定对象，下标从0开始）。例如：

   响应体结构如下：

   

   检查响应体“result”数组的第1个元素对象字段名为“userId”的值，检查点配置如下：

   

3. 检查响应体（JSON）中某个数组的对象的字段值（数组条件采用模糊匹配功能确定对象）。例如：

   响应体结构如下：

   

   a.检查响应体“result”数组下“name”是“啤酒”的所有对象取第1个之后获取id的值，检查点配置如下：

   

   

   当获取的数组下的对象只有一个，“[0]”可以省略，示例中的表达式可以写为“result[name==啤酒].id”。

   b.检查响应体“result”数组下“name”是“啤酒”的并且“obj”对象下属性“a”的值是“2”的对象的id值，检查点配置如下：

   

变量检查

检查比较全局变量，局部变量，响应提取后的变量值和目标值。例如：

• 检查全局变量“hostIp”的值是否等于“127.0.0.1”。
• 检查局部变量“local”的值是否等于“text”。
• 检查响应提取后的变量“name”的值是否等于“白酒”。

示例：根据给定的key:value从响应体中获取字符串

检查体的“属性”字段，可输入下标为“key:value”格式的数组，用以实现根据给定的“key:value”从响应体中获取满足该条件的json串。

“key:value”之间支持以下连接符：

数组下标支持以“&&”连接的多组“key:value”条件，表示提取的JSON串需要同时满足所有的“key:value”条件。例如：student[age>20&&gender=女]，表示提取条件为年龄大于20岁且性别为女。

数组的搜索条件中支持嵌套数组，在此情况下子嵌套条件中的对象必须全部满足条件，才能使得子条件成立。

• 若value值为空对象，则需要使用$null，即key==$null。
• 若value值是null串（"null"），则使用null，即key==null。
• 若value值是空串（""），则可以不写，即key==。

以下面的响应体（JSON格式）为例：

{
  "status": "success",
  "result": [
    {
      "name": "啤酒",
      "数量": "20",
      "地址": "A3库房10号货架",
      "obj": {
        "a": 1,
        "b": "test",
        "c": "测试"
      },
      "array": [
        {
          "id": 1,
          "name": "aaa"
        },
        {
          "id": 2,
          "name": "bbb"
        }
      ]
    },
    {
      "name": "啤酒",
      "数量": "10",
      "地址": "A3库房10号货架",
      "obj": {
        "a": 1,
        "b": "test",
        "c": "测试"
      },
      "array": [
        {
          "id": 1,
          "name": "aaa"
        },
        {
          "id": 2,
          "name": "bbb"
        }
      ]
    },
    {
      "name": "白酒",
      "数量": "20",
      "地址": "A3库房10号货架",
      "obj": {
        "a": 1,
        "b": "test",
        "c": "测试"
      },
      "array": [
        {
          "id": 1,
          "name": "aaa"
        },
        {
          "id": 2,
          "name": "bbb"
        }
      ]
    },
    {
      "name": "白酒",
      "数量": "30",
      "地址": "A3库房10号货架",
      "obj": {
        "a": 1,
        "b": "test",
        "c": "测试"
      },
      "array": [
        {
          "id": 3,
          "name": "aaa"
        },
        {
          "id": 4,
          "name": "bbb"
        }
      ]
    },
    {
      "name": null,
      "数量": "10",
      "地址": "A3库房10号货架",
      "obj": {
        "a": 2,
        "b": "test",
        "c": "测试"
      },
      "array": [
        {
          "id": 5,
          "name": "aaa"
        },
        {
          "id": 6,
          "name": "bbb"
        }
      ]
    },
    {
      "name": "",
      "数量": "10",
      "地址": "A3库房10号货架",
      "obj": {
        "a": 2,
        "b": "test",
        "c": "测试"
      },
      "array": [
        {
          "id": 5,
          "name": "aaa"
        },
        {
          "id": 6,
          "name": "bbb"
        }
      ]
    }
  ],
  "condition": [
    {
      "name": "啤酒",
      "数量": "120",
      "地址": "A1库房15号货架"
    }
  ],
  "reason": null
}

从响应体中获取数据与对应的表达式如下表所示：

若需要检查（JSON格式）name是白酒、且数量大于20的数据是不是“[{"name": "白酒","数量": "30","地址": "A3库房10号货架","obj": {"a": 1,"b": "test","c": "测试"},"array": [{"id": 3,"name": "aaa"},{"id": 4,"name": "bbb"}]}]”，则检查点各字段的配置可参考下表：

示例：根据JsonPath从响应体中获取数据

JsonPath详情可参见官网。

以下面的响应体（JSON格式）为例：

{
    "store": {
        "book": [
            {
                "category": "reference",
                "author": "Nigel Rees",
                "title": "Sayings of the Century",
                "price": 8.95
            },
            {
                "category": "fiction",
                "author": "Evelyn Waugh",
                "title": "Sword of Honour",
                "price": 12.99
            },
            {
                "category": "fiction",
                "author": "Herman Melville",
                "title": "Moby Dick",
                "isbn": "0-553-21311-3",
                "price": 8.99
            },
            {
                "category": "fiction",
                "author": "J. R. R. Tolkien",
                "title": "The Lord of the Rings",
                "isbn": "0-395-19395-8",
                "price": 22.99
            }
        ],
        "bicycle": {
            "color": "red",
            "price": 19.95
        }
    },
    "expensive": 10
}

JsonPath表达式可以使用点符号或者括号符号，例如：

• $.store.book[0].title
• $['store']['book'][0]['title']

JsonPath表达式与其对应的含义如下表所示：

若使用length函数或者size函数，则多次调用时不要使用深度扫描（即“..”符号），例如“$..book.length()”返回书的数量，此时需要确定路径，改为“$.store.book.length()”。