2020-05-27postman常见断言方式

前言: Postman 中提供了一系列的断言,不过都是通过提供预设的 JavaScript 语言代码来实现的。要使用 Postman 的断言,需要稍微有那么一点 JavaScript 基础。

响应结果断言:

Response body: Contains string
响应结果是否包含字符串;
Response body: JSON value check
响应结果如果是 JSON,检查具体的 JSON 值;
Response body: Is equal to a string
响应结果与字符串是否全部匹配预期的字符串;

1. Response body: Contains string

用来断言响应结果是否包含某字符串。可以认为是预期结果是否包含在实际结果中。比如我们的案例 showdoc 中有一个接口 /api/user/info,其返回值如下:


{
    "error_code": 0,
    "data": {
        "uid": "1",
        "username": "showdoc",
        "email": null,
        "name": "Nemo",
        "avatar": null,
        "avatar_small": null,
        "groupid": "1"
    }
}


那我们如果这个接口没有问题,获取用户资料成功,结果中就应该包含showdoc和Nemo的字符串。那么我们就可以使用Contains string来断言。
直接在 Postman 的 Tests 栏右侧点击Response body: Contains string会出现预设代码:


image.png

我们可以看到点击之后出现了一段 JavaScript 代码段。看到代码不要惊慌,我们不需要去动这段代码,我们只需要修改图中 ①②两个部分的内容。这两个部分都是由引号包裹起来的字符串。

① 表示断言标题,也就是你这个断言的目的是什么,主要是方便后续在运行时可以分辨出测试目的;
② 表示你的预期结果,也就是你预期结果中出现什么内容。
这里,我们预期结果中出现 showdoc和Nemo,那就需要写两条断言:

// 注意两段引号中的内容
pm.test("判断用户名showdoc是否包含于响应结果", function () {
    pm.expect(pm.response.text()).to.include("showdoc");
});
pm.test("判断用户姓名Nemo是否包含于响应结果", function () {
    pm.expect(pm.response.text()).to.include("Nemo");
});


写好后,运行一下。


image.png

可以看到,在下方的 Test Results 中会展示断言的结果,PASS 或者 FAIL.

这种断言方式可以用在任何地方,任意文本格式的数据。但是要注意使用的时候,慎重选取包含的内容,也就是预期结果。比如下面的一个接口返回值,预期结果选择中文就不行

接口返回如下:



{
"code": "SUCCESS",
"data": {
"content": [
            {
"applyId": "58",
"prodId": "00e375be4dda467ba6140e99ac68404c",
"prodName": "卓越七十一号",
"accountNatureId": "586",
"accountNatureName": "定期账户",
"fristAccountOpenBiz": "591",
"fristAccountOpenBizName": "协议存款",
"accountOpeningDepartmentName": "营运部",
"accountOpeningPerson": "742",
"accountOpeningPersonName": "鲁鲁",
"bankId": "014",
"applyTypeId": "608",
"applyTypeName": "邮件发送",
"applyRemark": "尽快完成开户审批流程",
"status": "2",
"verifyUserId": "lulu",
"verifyUserName": "鲁鲁",
"verifyTime": "2020-05-27 15:24:51",
"auditingUserId": "lulu",
"auditingUserName": "鲁鲁",
"crtTime": "2020-05-27 14:35:15",
"creator": "lulu",
"updateTime": "2020-05-27 15:24:50",
"updateUser": "lulu",
"del": false
            }
       ],
"pageable": {
"sort": {
"unsorted": false,
"sorted": true
            },
"pageSize": 1,
"pageNumber": 0,
"offset": 0,
"paged": true,
"unpaged": false
     },
"totalPages": 58,
"totalElements": 58,
"last": false,
"first": true,
"sort": {
"unsorted": false,
"sorted": true
        },
"numberOfElements": 1,
"size": 1,
"number": 0
    }
}

断言代码如下:

pm.test("响应结果包含产品名字", function () {
    pm.expect(pm.response.text()).to.include("卓越七十一号");
});

执行结果如下:

从报错信息看,响应体中的中文全部都是被转义了,现实中文是Unicode编码。而pm.response.text()),转成了text,是ASCII

至于通过json键值为什么能获取到中文,是因为使用的是json()方法自带转义

pm.test("获取json返回的键值进行断言", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.data.content[0].prodName).to.eql("卓越七十一号");

});

2. Response body: JSON value check

这个方法,稍微难一点,其用途是将 JSON 格式的响应结果转换成 JavaScript 对象 ,然后指定其中某一个字段的值进行断言。

简单来说,就是预期某一个具体字段的值是否符合预期,是一种更精确的断言方式。缺点是只支持响应结果为 Json 格式的接口。

同样,我们在右侧点击Response body: JSON value check,会出现如下代码段:


image.png

这里比 contains string 断言方式对了一个需要关注的地方。

① 断言标题
② 预期结果
③ 指定断言的字段
这里比较麻烦的是第三点jsonData.value的意思。

要明白jsonData.value,我们首先要明白 jsonData 怎么来的。

我们看预设代码中的第二句var jsonData = pm.response.json();

在 Postman 中有一个内置的 JavaScript 库 pm, 里面提供了请求处理过程中的很多函数。pm.response是指当前请求接收到的响应 body 内容(不能理解的同学先看看 HTTP 内容)。这里接口的响应 body 是一个 json 字符串,也就是我们上面展示的返回值。
json()方法是把 JSON 字符串转换为 JavaScript 对象。

至此,var jsonData = pm.response.json(); 变量 jsonData 相当于就是一个 JavaScript 对象。我们可以打印出来看看,当然要想看到打印结果需要使用快捷键(Ctrl+Alt+C)打开Postman Console


image.png

我们可以看到,打印出来的 jsonData 是一个 JavaScript 对象,其中包含了响应结果的所有内容。

那么预设代码的第三点,就是要通过 jsonData 里面的对象层级来提取对应字段的值去和预期结果做比较。

比如,我依然想判断 username 字段的值预期是否为 showdoc。那就需要从 jsonData 变量中提取出来。但是我们发现 username 字段是在 data 内部。当然这里不是很直观,我们可以在 Postman 上看。


image.png

我们提取时,需要用jsonData.data.username来提取 username 的值,也就是说需要按层级来。
如果想取 error_code 的话,直接写为jsonData.error_code即可。

我们的断言代码就可以写为:

// 注意观察我们标注出的三个部分代码的变化
pm.test("判断username字段的值是否为showdoc", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.data.username).to.eql('showdoc');
});


最后,如果你是断言数值类型的话,第三句的 eql()函数还有其他几种用法:

eql 等于
lt 小于
lte 小于等于
gt 大于
gte 大于等于

3. Response body: Is equal to a string

最后一种常用的,是预期结果与实际结果完全匹配。注意是完全哦,符号、空格都不能有区别


image.png

代码如下:

pm.test("响应结果是否完全符合预期", function () {
    pm.response.to.have.body('{"error_code":0,"data":{"uid":"1","username":"showdoc",\
"email":null, "name":"\\u61d2\\u732bNemo","avatar":null,"avatar_small":null,"groupid":"1"}}');
});


这里要注意两点:

1.由于 JSON 格式要求必须使用双引号,因此在外面要使用单引号;
2.如果遇到中文,会以 ASCII 字符表示(如懒猫,\u61d2\u732b),需要使用反斜杠“\”转义。

转载:https://blog.csdn.net/minzhung/article/details/102492705?from=timeline&isappinstalled=0

遗留问题:

postman contains String 断言, 如何解决返回值有unicode编码?即如何把unicode编码转成中文??

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,036评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,046评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,411评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,622评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,661评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,521评论 1 304
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,288评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,200评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,644评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,837评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,953评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,673评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,281评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,889评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,011评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,119评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,901评论 2 355