『政善治』Postman工具 — 9、在Postman中使用断言

目录

我们检验一个测试用例是否通过，一般会将我们心理预期的结果与实际结果进行比对，如果结果一致则证明测试通过，如果结果不一致，则证明测试不通过，这即是我们经常所说的断言。

1、Tests的介绍

Postman中的断言是使用请求后脚本Tests，是对状态码、响应头、响应正文等信息进行断言操作。

在Postman中封装了我们常见的断言代码片段，当然Tests除了可以作为断言，还可以当做后置处理器。

经常应用于：

  1. 断言。
  2. 获取当前接口的响应数据，传递给下一个接口。

提示：在一个请求或者一个集合都可以定义Tests，在集合中定义Tests，表示集合中的每一个请求响应后，都需要执行Tests中的断言脚本。

点击请求中的Tests标签项，如下图：

image

我们可以在上图看到，在Tests标签页的右侧边栏中，Postman为我们提供了一些常用的代码模版。

提示我们：

Test scripts are written in JavaScript, and are run after the response is received.
测试脚本用JavaScript编写，并在收到响应后运行。

Learn more about tests scripts
点击这里，可以学习更多关于测试脚本的资料。

学习关于Tests的更多用法，请进入后面链接：//go.pstmn.io/docs-test-scripts。

总结：

（1）Postman测试沙箱的执行顺序

  1. 在发送Request之前，执行Pre-request Script中的js脚本，可定制化Request（准备数据）。
  2. 收到Response之后，执行Tests中的脚本，处理返回的数据（断言或者处理数据）。

整个流大概是这样的：

image

（2）Postman中Tests的作用

  1. 做断言：可以断言状态码或者断言返回数据中的字段。
  2. 取返回值：做流程接口的时候，向下传递返回数据。

2、常用SNIPPETS（片段）说明

（1）常用变量相关

  • Get an environment variable：获取一个环境变量。
  • Get a gloval variable：获取一个全局变量。
  • Get a variable：获取一个变量（本地）。
  • Set an environment variable：设置一个环境变量。
  • Set a global variable：设置一个全局变量。
  • Clear an environment variable：清空一个环境变量。
  • Clear a global variable：清空一个全局变量 。

使用：

  • 获取变量：如果在下一个请求中用到上一个请求的返回值，可以使用“设置一个环境变量”，将请求的返回值设置为环境变量，在下一个请求中，使用“获取一个环境变量”取到该值。
  • 清空变量：这里的清空等于删除变量，一个参数使用完成后，需要删除，或者清空值都可以使用该方法。

（同前一篇Pre-request Script的使用方式一样）

（2）状态码相关

  • Status code: Code is 200 ：判断状态码是否正确；默认判断状态是否为 200， 可修改。 
    pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});
  • Status code:Successful POST request：
    判断状态码是否为预期结果之一；比如默认断言状态码是否是 201， 202 中的一个。

    pm.test("Successful POST request", function () {
    pm.expect(pm.response.code).to.be.oneOf([201, 202]);
});
  • Status code:Code name has string
    判断状态码描述是否包含字符串，比如是否包含 Created。

    pm.test("Status code name has string", function () {
    pm.response.to.have.status("Created");
});

（3）响应结果断言：

  • Response body: Contains string ：
    响应结果是否包含字符串；
    注意：这只能检查Response body中raw格式展示的返回数据，如果raw格式展示的返回数据中，有中文数据未解码，也只能匹配未解码形式的内容，且匹配包含不唯一（工作中很少见，一般接口返回数据中不会设计重复字段）。

    pm.test("Body matches string", function () {
    // 比如raw中的数据，“学院”没有进行Unicode解码，就只能如下方式进行比对。
    pm.expect(pm.response.text()).to.include("例如：\u5b66\u9662");
});
  • Response body: JSON value check ：
    响应结果如果是 JSON格式的数据，检查具体的 JSON字段的值；
    实际工作中基本就用这个方式。（下面有练习好好看看）

    pm.test("Your test name", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.value).to.eql(100);
});
  • Response body: Is equal to a string ：
    响应结果与字符串是否全部匹配预期的字符串；
    就是在把Response body的数据用raw格式展示，然后全部复制到下面位置。

    pm.test("Body is correct", function () {
    pm.response.to.have.body("raw格式展示的返回数据，全部复制到这里");
});
  • Response body: Convert XML body to a JSON Object：
    将 XML 转换成 JSON；

    var jsonObject = xml2Json(responseBody);

等等还有很多，用的时候我们可以查看相关文档。

（4）Header ：

Response headers:Content-Type header check
响应头部中是否包含字段，代码片段如下：

pm.test("Content-Type is present", function () {
    pm.response.to.have.header("Content-Type(这里填写请求头属性)");
});

（5）响应速度：

Response time is less than 200ms
响应时间是否少于多少 ms。

pm.test("Response time is less than 200ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(200);
});

3、示例

（1）响应码断言

我们以“添加学院测试为例”

1）准备数据

在Pre-request Script编辑如下代码，来准备数据

// 随机生成一个3位数字的id
var dep_id = Math.floor(Math.random()*1000);
pm.environment.set("depid" , dep_id); //设置到环境变量中

// 随机生成学院名称dep_name
// 随机生成一个10位的字符串
var data = Math.random().toString(36).slice(-10) ;
var dep_name = data+"学院";
pm.environment.set("dep_name" , dep_name);//设置到环境变量中

// 随机生成院长的名字
var first_name = ["赵","钱","孙","李","刘"];
var last_name = ["子鼠","丑牛","寅虎","牟兔","辰龙","巳蛇"];
var master_name = first_name[Math.floor(Math.random() * (first_name.length))] +last_name[Math.floor(Math.random() * (last_name.length))];
pm.environment.set("master_name" , master_name);//设置到环境变量中

// 随机生成口号
var slogan_str = ["吃饭","睡觉","打豆豆"];
var slogan = slogan_str[Math.floor(Math.random() * (slogan_str.length))];
pm.environment.set("slogan" , slogan);//设置到环境变量中


// 很low的代码，只做练习

2）编辑请求所要提交的数据

image

3）编写Tests中的断言

使用Tests中的Status code: Code is 200内置代码片段。

// 用来断言接口请求的状态码，针对HTTP协议状态码。
// pm.test 表示Postman进行测试断言
// "Status code is 200" 表示断言的名称或者说明，一般和测试用例同名
// function 表示 执行断言的方法
pm.test("新增学院请求正常放回201", function () {
    pm.response.to.have.status(201);
});

4）查看断言结果

如下图：

image

提示：

Test Results(1/1)：表示一共有1个断言，执行通过了1个断言。

All：表示显示所有断言。

Passed：表示只显示通过的断言。

Skipped：表示只显示跳过的断言。

Failed：表示只显示失败的断言。

当我们断言执行失败时，也会有详细提示，如把上面的状态码改成202。

image

AssertionError: expected response to have status code 202 but got 201

AssertionError：预期响应的状态码为202，但得到201。

（2）返回值断言（非常频繁）

返回值断言，就是对接口返回的数据（body主体）中的字段进行验证。

以返回值为json格式的数据为例：

这里先标识一下，接口的实际返回结果如下：

{
    "create_success": {
        "count": 1,
        "results": [
            {
                "dep_id": "637",
                "dep_name": "k7iwvtgk2h学院",
                "master_name": "李子鼠",
                "slogan": "睡觉"
            }
        ]
    },
    "already_exist": {
        "count": 0,
        "results": []
    }
}

同上面练习，直接编写Tests中的断言，

使用Tests中的Response body: JSON value check内置代码片段。

// 断言返回值为json格式的数据
// pm.test 表示Postman进行测试断言
// "Your test name" 表示断言的名称或者说明，一般和测试用例同名
// function 表示 执行断言的方法
// jsonData 表示接口返回的所有数据
// pm.expect 表示设置断言的预期
// jsonData.value 表示取具体的某一字段，一级一级点下去就可以（层级关系）
pm.test("断言添加学院数量", function () {
    var jsonData = pm.response.json(); // 获取返回值所有数据
    pm.expect(jsonData.create_success.count).to.eql(1); // 断言返回值中具体字段的值
});

然后执行并查看结果：

image

说明：

如果结果返回的json数据中有数组，如下：我们要取slogan字段

{
    "create_success": {
        "count": 1,
        "results": [
            {
                "dep_id": "637",
                "dep_name": "k7iwvtgk2h学院",
                "master_name": "李子鼠",
                "slogan": "睡觉"
            }
        ]
    },
    "already_exist": {
        "count": 0,
        "results": []
    }
}

需要如下方式进行选取：

pm.test("断言添加学院的口号", function () {
    // 获取返回值所有数据，赋值给jsonData
    var jsonData = pm.response.json(); 
    // 可以使用console.log在控制台输出内容，进行调试
    // console.log(jsonData.create_success.results[0].slogan)
    // 断言返回值中具体字段的值
    pm.expect(jsonData.create_success.results[0].slogan).to.eql("哈哈哈"); //这里是重点
});

其他代码片段使用方式同理，这里就不一一举例了。其实Tests中编写的就是JavaScript脚本，你也可以编写循环、判断、输出到控制台等代码。

Tags:

VirMach 便宜 VPS

QNews

QNews