【接口工具ApiPost】预后执行脚本、断言、测试验证定义使用（5）

Posted 2023-04-02

参考技术A 脚本语法
javascript语法规则
实现功能有：
测试（断言）请求返回结果的正确性（后置脚本）。
动态修改接口请求参数，如增加接口签名参数等（前置脚本）。
接口请求之间传递数据（使用脚本操作变量）。
脚本中可以直接请求一个接口地址。

例子：在预执行脚本中定义一个函数_random

预后执行脚本都可定义、获取、删除、清空环境变量、全局变量等
例子如下：

后执行脚本还可进行断言和响应结果数据可视化设置

断言
1、断言定义
2、断言验证
返回响应数据如下

定义：在后执行脚本里添加；
特别注意：每个测试用例是一行，不能换行。

验证结果：

绿色表示测试通过，红色表示测试不通过
【补充】集合（list）验证
定义：

笔者暂时还没有找到添加断言业务描述的参数方法，一般断言有断言描述和断言表达式。但这个语法上好像不支持。后期如果找到一并补充上

postman使用--断言

前戏

在我们测接口的时候，没有断言的接口都是耍流氓，因为做自动化的时候，不加断言我们不知道这个接口是执行成功了还是执行失败了，所以断言是做接口自动化必须的

断言

断言就是我们预期值和接口返回值是否一样，就和我们写功能测试用例时的预期结果一个意思

pre-request Script（预置脚本）可以用来修改一些默认参数，在请求发送之前执行
test Scripr（测试脚本）：当接受到响应之后，在执行脚本

还是我们上节讲的A接口，我们来断言返回值中是不是有zouzou666，如果有，则认为接口执行成功，没有则失败

 在test里设置断言

pm.test("包含字符串",function()
pm.expect(pm.response.text()).to.include("zouzou666");
);

如果执行成功则在Test Results里显示PASS，那我们把断言改为失败试试

我们发现，断言失败会显示成FALL的，当然我们可以在Test下面添加多个断言

postman脚本执行顺序

也就是先执行最上层的文件夹里的pre-request Script，在执行它下面文件夹里的pre-request Script，在执行请求里的pre-request Script。在发送请求，在执行最上层的文件夹里的Tests，在执行它下面文件夹里的Tests，最后执行请求里的Tests

常用的断言

断言返回的状态码是不是200

tests["返回状态码正确"]=responseCode.code===200;

pm.test("返回正确",function()
    // pm.response.to.have.status(200);    
    pm.response.to.be.ok;
)

pm.test("包含字符串",function()
    pm.expect(pm.response.text()).to.include("@#sd1135");
);

pm.test("包含字符串",function()
    pm.expect(pm.response.text()).to.include("38dd572dd9c14c73b7637893c0592aa7");
);

pm.test("包含字符串",function()
    pm.expect(pm.response.text()).to.include("10");
);

设置环境变量

pm.environment.set("variable_key", "variable_value");

将嵌套对象设置为环境变量

var array = [1, 2, 3, 4];
pm.environment.set("array", JSON.stringify(array, null, 2));

var obj =  a: [1, 2, 3, 4], b:  c: ‘val‘  ;
pm.environment.set("obj", JSON.stringify(obj));

获取环境变量

pm.environment.get("variable_key");

获取环境变量（其值是字符串化对象）

var array = JSON.parse(pm.environment.get("array"));
var obj = JSON.parse(pm.environment.get("obj"));

清除环境变量

pm.environment.unset("variable_key");

设置全局变量

pm.globals.get("variable_key");

清除全局变量

pm.globals.unset("variable_key");

检查响应主体是否包含字符串

pm.test("Body matches string", function () 
    pm.expect(pm.response.text()).to.include("string_you_want_to_search");
);

检查响应主体是否等于字符串

pm.test("Body is correct", function () 
    pm.response.to.have.body("response_body_string");
);

检查JSON值

pm.test("Your test name", function () 
    var jsonData = pm.response.json();
    pm.expect(jsonData.value).to.eql(100);
);

内容类型存在

pm.test("Content-Type is present", function () 
    pm.response.to.have.header("Content-Type");
);

响应时间小于200毫秒

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

状态代码是200

pm.test("Status code is 200", function () 
    pm.response.to.have.status(200);
);

代码名称包含一个字符串

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

成功的POST请求状态代码

pm.test("Successful POST request", function () 
    pm.expect(pm.response.code).to.be.oneOf([201,202]);
);