Postman 断言

• postman 断言借助js 语言编写代码，自动判断预期结果与实际结果是否一致。
• 断言 代码写在 Tests 的标签中。

1. Postman 常用断言

1.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：匿名函数。
pm.response.to.have.status(200); 
// 意思：postman 的响应结果中应该包含状态码 200
        200 ——> 预期结果！

1.2 断言响应体是否包含某个字符串

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：匿名函数
pm.expect(pm.response.text()).to.include("string_you_want_to_search"); 
// 意思：pm 期望 响应文本 中，包含 xxxx 字符串。
    "string_you_want_to_search" ——> 预期结果。 可以修改

1.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" ——> 预期结果。 可以修改

1.4 断言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);
});
// var jsonData： 用js语法定义一个变量。jsonData 就是变量名
// pm.response.json();  代表响应的json结果

/* 举例：response.json();
{
    "success": true,
    "code": 10000,
    "message": "操作成功！",
    "data": "95c78d75-721c-40fb-b2d5-742fea42cbd5"
}
*/
pm.expect(jsonData.value).to.eql(100);
// 意思：pm 预期 json结果 key对应的值 等于 xxx
// to.eql(100); 中的 100 代表预期结果。可以修改的。

示例：
// 断言json的响应结果-success的值为true
pm.test("断言响应结果success的值为true", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.success).to.eql(true);
});

pm.test("断言响应结果中code的值为10000", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.code).to.eql(10000);
});

pm.test("断言响应结果中message的值为 操作成功", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.message).to.eql("操作成功！");
});

1.5 断言响应头

Response headers: Content-Type header check

// 断言响应头
pm.test("Content-Type is present", function () {
    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");
});

全局变量和环境变量

1. 全局变量

• 概念：在 Postman 全局生效的变量，全局唯一
• 设置：
  代码设置：pm.globals.set(“全局变量名”，全局变量的值)

     pm.globals.set("glb_age", 100)

• 获取：

  代码获取: var 接收值的变量 = pm.globals.get(“全局变量名”)

     var ret = pm.globals.get("glb_age")  // ret 的值为 100

  请求参数获取:（postman界面获取）: {{全局变量名}}

     {{glb_age}}

2. 环境变量

• 概念：在 特定环境（生产环境、开发环境、测试环境）下，生效的变量，在本环境内唯一。

  
  
• 设置：
  代码设置：pm.environment.set("环境变量名", 环境变量值)

      pm.environment.set("env_age", 99)

• 获取：
  代码获取：var 接收值的变量 = pm.environment.get("环境变量名")

      var ret = pm.environment.get("env_age")  // ret 的值为 99

  请求参数获取（postman界面获取）：{{环境变量名}}

      {{env_age}}

Postman 请求前置脚本

在 send 按钮点击后，请求前置脚本代码，第一时间被执行。在 postman 内部实际 http请求之前。

案例:

调用百度首页接口，传时间戳给服务器

实现步骤：
1） 在 Pre-request Script 标签页中，添加代码。拿到时间戳，写入全局变量

    // 拿到时间戳
    var timestamp = new Date().getTime()
    // 将时间戳设置到 全局变量
    pm.globals.set("glb_timestamp", timestamp)

2）点击 Send 按钮，发送请求。请求发送前执行 上述代码。写入全局变量
3）查看写入的变量

4）在 请求参数(界面)中，使用全局变量。{{全局变量名}}

Postman 关联

应用于 多个 http请求之间，有数据关联、或依赖关系时。

1. 实现步骤

A接口 依赖 B接口 的数据
1）向B接口发送http请求，获取数据
2）将数据 设置 至 全局变量（环境变量）中
3）A 接口 获取 全局变量（环境变量）中 数据值，进行使用。

案例：

请求 获取天气接口， 提取响应结果中的 城市， 将城市名，给百度搜索接口使用。

实现步骤：
1）创建 用例集，分别创建 查询天气 请求 和 百度搜索的请求

2）在查询天气请求 Tests 中，编写代码 获取 城市名，写入全局变量

    // 获取 全部响应结果
    var jsonData = pm.response.json()
    // 从响应结果中 获取 城市名
    var city = jsonData.weatherinfo.city
    // 将城市名写入到全局变量
    pm.globals.set("glb_city", city)

3）点击 Send 按钮，发送 请求，查看设置的全局变量。（可以先创建全局变量或者局部变量，就不需要先点击发送请求了，直接批量执行用例即可）

批量执行测试用例

Postman参数化

当 http请求，使用的 数据有较高相似度，相同的请求时，考虑使用参数化（将数据组织到数据文件中）。

1. 数据文件简介

CSV
- 优点：
数据组织形式简单，适用于大量数据的场合。
- 缺点：
1）不支持 bool类型数据。（数据被 postman读入后，自动添加 “” 包裹bool值。）
2）不支持 多参、少参、无参、错误参数 的接口测试。
3）不支持复杂数据类型。（如 嵌套字典、列表等）
JSON：
- 优点：
1）支持 bool 类型。
2）支持 多参、少参、无参、错误参数。
3）支持复杂数据类型。
- 缺点：
- 对于相同数据量，json数据文件大小远大于 CSV文件。

2. 导入外部数据文件

2.1 CSV文件

1）创建 xxx.csv 文件。
2）将数据写入到 csv文件中。
第一行 写入 的是 数据对应的 “字段名”。
从第二行向后依次是对应的数值，数据间用 英文逗号隔分。

3）在 Postman 中，选中使用数据文件的 用例集，导入数据文件。
  a. 点击用例集名称，使用 Run 按钮，进入 “Runner” 页面。
  b. 使用 “Select File” 按钮选择 xxx.csv 文件。
  c. 点击 预览按钮，校验数据文件是否正确。

2.2 JSON文件

1）创建 xxx.json 数据文件
2）在 数据文件中，按json 语法写入json数据。postman要求，json格式的数据文件，数据内容的最外层，必须是 [ ] 。内部所有的数据用 {} 存储。（ 建议：使用 json.cn 在线网站编写。）
3）在 Postman 中，选中使用数据文件的 用例集，导入数据文件。
  a. 点击用例集名称，使用 Run 按钮，进入 “Runner” 页面。
  b. 使用 “Select File” 按钮选择 xxx.json 文件。
  c. 点击 预览按钮，校验数据文件是否正确。

3. 读取数据文件数据

根据使用数据 位置 不同，有两种获取数据文件中数据的方法。

• 第一种：请求参数（请求行、请求头、请求体）中，使用 数据文件中 的数据 使用 {{}} 包裹 csv 文件 字段名 或 json 文件中的 key
  如： {{username}} 或 {{password}}
• 第二种：代码（断言、请求前置脚本）中，使用 数据文件中 的数据，需要借助 postman 提供的 关键字data 点 csv 文件的字段名 或 json文件的 key
  如： data.username 或 data.password

案例

需求：批量查询手机号归属地、所属运营商，校验运营商数据正确性
接口： http://cx.shouji.360.cn/phonearea.php?number=13012345678
测试数据：
手机号: 13012345678 运营商: 联通
手机号: 13800001111 运营商: 移动
手机号: 18966778899 运营商: 电信

1）测试单个接口，参数和 响应体 数据对应关系。

Postman 测试报告

1. 安装newman

需要先安装node.js
npm install -g newman
npm install -g newman-reporter-html

2. 使用newman生成测试报告

步骤：
1）批量执行测试用例集。（确认无误）
2）导出 Export 用例集。（得到 xxxx.json文件）
3）在 终端 中 执行命令，生成测试报告
完整的命令
newman run xxxx.json -e 环境变量文件 -d 外部数据文件 -r html --reporter-html-export 测试报告名.html
示例：
newman run 批量执行测试用例.postman_collection.json -r html --reporter-html-export 我的第一个测试报告.html