【接口测试】3_Postman _Postman断言

文章目录

• [一、Postman 断言简介](#一、Postman 断言简介)
• 二、解决Postman没有tests
• [三、Postman 常用断言](#三、Postman 常用断言)
• • [3.1 断言响应状态码（重点）](#3.1 断言响应状态码（重点）)
  • [3.2 判断返回响应体](#3.2 判断返回响应体)
  • • [3.2.1 断言包含某字符串](#3.2.1 断言包含某字符串)
    • [3.3.3 断言等于某个字符串](#3.3.3 断言等于某个字符串)
  • [3.3 断言JSON数据(重点)](#3.3 断言JSON数据(重点))
  • [3.4 断言响应头](#3.4 断言响应头)
• [四、Postman 断言工作原理](#四、Postman 断言工作原理)
• 五、小结

一、Postman 断言简介

Postman断言： 让Postman工具代替人工自动判断预期结果和实际结果是否一致。

用法：

• postman 断言借助 JavaScript语言编写代码，写在 'Tests' 的标签页里。
• Tests中的脚本在发送请求之后执行，会把断言的结果（PASS/FAIL）最终在'Test Results'标签页中展示。

二、解决Postman没有tests

• 在 Scripts下的Post-response里，Post-response即为tests功能。
• 官网说明：https://learning.postman.com/docs/tests-and-scripts/write-scripts/test-scripts/

三、Postman 常用断言

3.1 断言响应状态码（重点）

Status code: Code is 200

1. 在 Tests 标签中，选中 Status Code：code is 200， 生成对应代码
2. 适当调整 test() 方法参数1，和 匿名函数中的 预期结果。
3. 点击 send 按钮，发送请求，执行断言代码。
4. 查看断言结果。

// 判断响应状态码 是否等于200
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});


------------------------------------------------------------
pm：postman 的一个实例(对象)。  实例：类下面的一个对象
test()：pm实例的一个方法。有两个参数
	参数1：断言成功后，给出的文字提示。可以任意修改。（不参与断言，只是给个文字提示）  "Status code is 200"
	参数2：匿名函数。 function () {pm.response.to.have.status(200);}

pm.response.to.have.status(200); 
// 意思：postman 的响应结果中应该包含状态码 200
		200 ------> 预期结果！

3.2 判断返回响应体

3.2.1 断言包含某字符串

Response body: Contains string

// 断言响应体包含指定字符串
pm.test("Body matches string", function () {
    pm.expect(pm.response.text()).to.include("string_you_want_to_search");
});


------------------------------------------------------------------解释
pm：postman的一个实例
test(): postman实例的方法，有两个参数
	参1：断言后显示的文字提示信息，可改。（不参与断言，只是给个文字提示）
    参2：匿名函数  function() {pm.expect(pm.response.text()).to.include("string_you_want_to_search");}

其中 pm.expect(pm.response.text()).to.include("string_you_want_to_search"); 
// 意思：pm 期望 响应文本 中，包含 xxxx 字符串。
	    "string_you_want_to_search" ------> 预期结果。 可以修改

3.3.3 断言等于某个字符串

Response body: Is equal to a string

// 断言 响应体 等于某个字符串（对象）
pm.test("Body is correct", function () {
    pm.response.to.have.body("response_body_string");
});


-------------------------------------------------------------------解释
pm.response.to.have.body("response_body_string");
// 意思是，pm 的 响应中应该有 响应体 xxx
"response_body_string" ------> 预期结果。 可以修改

3.3 断言JSON数据(重点)

Response body: JSON value check

// 断言json的响应结果
pm.test("Your test name", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.value).to.eql(100);
});


-----------------------------------------------------------------------------------解释
pm:postman的一个实例
test(): postman的方法。有两个参数。
	参1：断言完成后，给用户的提示性文字信息。可以任意修改（不参与断言，只是给个文字提示）
    参2：是一个 匿名函数 调用。
var jsonData = pm.response.json();
	var 是 js 语言中，定义变量的关键字。
    jsonData 是变量名
    pm.response.json() 表示 postman的 json响应结果
    代表：
    {
        "success": true,
        "code": 10000,
        "message": "操作成功！",
        "data": "46b1fcde-e996-4520-b8f6-a2cd2da95350"
	}
pm.expect(jsonData.value).to.eql(100); 
	value 指代 json数据中的 "key" (举例：可以取：success 或 code 或 message 或 data)
	100，应该替换为 key 所对应的 value (预期结果，可以修改)

3.4 断言响应头

Response headers: Content-Type header check

// 断言响应头
pm.test("Content-Type is present", function () {
    pm.response.to.have.header("Content-Type");
});


-------------------------------------------------------------解释
pm.response.to.have.header("Content-Type");
pm 的响应头中包含 Content-Type

示例：可以在 header 中，添加 响应头中的 key 对应的 value 判定。用 ，隔分。
断言响应头
pm.test("Content-Type is present", function () {
    pm.response.to.have.header("Content-Type", "application/json;charset=UTF-8");
});

四、Postman 断言工作原理

五、小结