Postman pm 对象 - 测试相关功能

Posted 2023-03-20

参考技术A

pm 对象还提供了测试相关功能：

pm.test(testName:String, specFunction:Function):Function ：

这个函数已经在我们之前的文章中出现过很多次了，只是那时候不需要大家深入了解，使用预设的语句就可以了。

与 tests 对象不同，使用 pm.test() 函数编写测试可以准确地命名测试。

即使该函数内部存在错误，该函数也可以确保脚本的其余部分不会被阻塞。

pm.test(testName:String, specFunction:Function) 接收两个参数： testName 用字符串输入一个测试名称，会显示在最终报告上；specFunction 接收一个回调函数，在该回调函数内部运行断言语句。

pm.expect(assertion:*):Function → Assertion ：

pm.expect 是一个通用的断言函数。这是一个基于 javascript BDD 库 ChaiJS 开发的功能。使用 ChaiJS 库，可以很容易地编写语法易读的测试。（BDD 嘛，行为驱动开发，用自然语言的形式描述测试过程，当然易读）所以语法与 ChaiJS 一致。

该函数对于处理来自响应 response 或变量 variables 的数据断言很有用。pm.expect 主要与 pm.test 联用。

expect 是期望的意思，也就是传递给 expect 函数的值是否符合预期。通过一系列的调用链来实现。

常见的用法如：

与 .to 一样，expect 还提供了很多连接符，这些连接符并不会对结果造成任何影响，主要目的是让断言语句更符合英文文法。也就是说你随便写都可以。

除了 .to 以外还有如下连接符：

相等： .equal(value)

断言目标严格等于(===)value。

取非： .not

对之后的断言无条件取反

expect(foo).to.not.equal(\'bar\')
expect(goodFn).to.not.throw(Error)
expect( foo: \'baz\').to.have.property(\'foo\')
.and.not.equal(\'bar\')

包含： .include(value) / .contains(value)

表示实际结果是否包含预期结果，两个函数用法一致。

判断结果是否为真： .ok/.true

断言目标为真值。.true 与 .ok 的区别是不进行类型转换，只能为布尔值 true 才能通过断言。

以上列出了最常用的一些断言方式，如果有兴趣的同学可以查看这位博主的翻译内容 《ChaiJS 断言库 API 中文文档》

以下是 pm.response 对象内置的断言语句，可以在不使用 expect 函数的情况下直接使用：

判断 json 结果示例：

postman——集合——执行集合——测试脚本——pm对象简单示例02

//1.验证返回状态码是否是200
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});




//2.验证返回body内是否含有某个值
pm.test("Body matches string", function () {
    pm.expect(pm.response.text()).to.include("string_you_want_to_search");
});




//3.验证某个返回值是否是100
pm.test("Your test name", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.value).to.eql(100);
});




//验证返回body中是否含有某个字符串
pm.test("Body is correct", function () {
    pm.response.to.have.body("response_body_string");
});




//验证返回头类型
pm.test("Content-Type is present", function () {
    pm.response.to.have.header("Content-Type");
});




//验证请求时长是否小于200ms
pm.test("Response time is less than 200ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(200);
});




//验证返回码是否为200
pm.test("Successful POST request", function () {
    pm.expect(pm.response.code).to.be.oneOf([201,202]);
});




//验证返回数据中是否包含某个字符串
pm.test("Status code name has string", function () {
    pm.response.to.have.status("Created");
});




//验证json数据的微小验证器
var jsonObject = xml2Json(responseBody);
var schema = {
  "items": {
    "type": "boolean"
  }
};
var data1 = [true, false];
var data2 = [true, 123];
pm.test(‘Schema is valid‘, function() {
  pm.expect(tv4.validate(data1, schema)).to.be.true;
  pm.expect(tv4.validate(data2, schema)).to.be.true;
});