Postman常用小结

Postman基础使用

一、常用功能简介

1.1 Postman页面概览

下图使用的版本是Postman v9.31.27，不同版本的Postman页面可能略有不同，但基础用法是不变的，以此版本为例，小结常用的功能。

1.2 接口请求的编辑

进入选择的工作空间(Workspace，若无则需创建)，再在当前工作空间新增集合(Collection)，Postman中集合的概念类似于Eclipse中的项目(Project)，集合下可新增文件夹，不同层级的文件夹均可创建其子文件夹，文件夹用于管理项目中的不同功能模块或接口用例。

（1）接口编辑区功能及作用

（2）脚本编辑

主要用于请求前预置脚本（Pre-request Script，相当于自动化中的setUp()）和响应后断言（Test Script，相当于自动化中的teardown()与断言），使用JavaScript编写。需要注意的是Pre-request Script与Test脚本在Collection、Folder、API中都有，如下图：

脚本执行顺序

不同级别的脚本执行顺序如下图：

变量作用范围

若有数据驱动文件时，要注意变量的作用范围：

全局变量(Global variables)：全局变量使测试人员能够访问集合、请求、测试脚本和环境之间的数据。全局变量在整个工作区中可用。由于全局变量在Postman中具有最广泛的范围，因此它们非常适合于测试和原型设计。在以后的开发阶段，使用更具体的范围。

Collection variables(集合变量)：集合变量在集合中的所有请求中都可用，并且与环境无关。集合变量不会根据所选环境而更改。如果测试人员使用的是单个环境，例如用于身份验证或URL详细信息，则集合变量是合适的。

Environment variables(环境变量)：环境变量使测试人员能够将工作范围扩展到不同的环境，例如本地开发与测试或生产。一次可以激活一个环境。如果测试人员有一个单独的环境，使用集合变量可能会更有效，但环境允许测试人员指定基于角色的访问级别。

Data variables(数据变量)：数据变量来自外部CSV和JSON文件，用于定义在使用Newman或Collection Runner运行集合时可以使用的数据集。数据变量具有当前值，这些值在请求或收集运行之后不会持续存在。

Local variables(局部变量)：局部变量是在请求脚本中访问的临时变量。本地变量值的作用域为单个请求或集合运行，并且在运行完成后不再可用。如果测试人员需要一个值来覆盖所有其他变量范围，但不希望该值在执行结束后保持不变，则本地变量是合适的。

Pre-request script示例：

背景：在vue_shop项目中，所有的接口操作都需要先登录管理员账号admin，获取token鉴权才能操作成功，此时可用接口关联。即：

在Collection中添加一个获取管理员token的Pre-request script，并将获取的token设置为Collection级别的变量。之后，此Collection中的所有接口直接从Collection级别的token变量中获取此值即可。

代码如下：

// 获取token, 避免后续需在请求头中身份认证的接口重复填充Authorization

const LoginRequest = {
    
    
  url: 'http://127.0.0.1:8888/api/private/v1/login',
  method: 'POST',
  header: 'Content-Type:application/json',
  body: {
    
    
    mode: 'raw',
    raw: JSON.stringify({
    
     "username": 'admin',"password":"123456" })
  }
};

pm.sendRequest(LoginRequest, function (err, res) {
    
    
  console.log(err ? err : res.json());
    // slice(7)是因为响应的token的值是 Bearer eyJhbGciOiJI...，
    // Postman在设置Authorization时会自动填充Bearer，截取token[7:]
  var token = res.json().data.token.slice(7);
  pm.collectionVariables.set("token", token);
});

之后按下图的操作即可实现接口关联：

Test script示例：

// 用于响应后断言
pm.test("校验登录成功", function () {
    
    
    var jsonData = pm.response.json();
    var msg = jsonData.meta.msg;
    pm.expect(msg).to.eql("登录成功");
});

pm.test("校验登录名为admin", function () {
    
    
    var jsonData = pm.response.json();
    var username = jsonData.data.username;
    // var expection = data.username;
    pm.expect(username).to.eql("admin");
});

pm.test("校验登录账号的电话号码为12345678", function () {
    
    
    var jsonData = pm.response.json();
    var mobile = jsonData.data.mobile;
    pm.expect(mobile).to.eql("12345678");
});

pm.test("校验登录账号的邮箱地址为[email protected]", function () {
    
    
    var jsonData = pm.response.json();
    var email = jsonData.data.email;
    pm.expect(email).to.eql("[email protected]");
});

设置的四个检查点全部通过，运行结果如下：

Script帮助

在Postman中，编写script时使用右侧的快捷方法，点击即可自动生成：

或在Postman官网中，了解各常见断言方法样例，熟悉后在使用，官方文档链接为：

https://learning.postman.com/docs/writing-scripts/script-references/test-examples/，此链接若失效，可按如下方法进入

Dynamic variable的使用示例如下：

（3）API测试加解密函数

散列函数

// 导入加密包 crypto-js
var CryptoJS = require("crypto-js");

// 散列函数
CryptoJS.MD5('待加密的字符串') //返回WordArray对象

加解密函数

此处参考引用自链接：https://www.cnblogs.com/huiguo/p/16601076.html。

加密函数参数是：(明文字符串, 密钥字符串, 可选参数对象)，返回密文字符串。

加密函数有Cryptojs.AES.encrypt，Cryptojs.DES.encryp，Cryptojs.Rabbit.encrypt，Cryptojs.RC4.encrypt，Cryptojs.TripleDES.encrypt,

其中最常用的是Cryptojs.AES.encrypt。

解密函数的参数是：(密文字符串, 密钥字符串，可选参数对象)，返回的结果必须用.toString(CryptoJS.enc.Utf8)转为明文，因为加密后得到的密文不是字符串，它是一个CipherParams对象。
解密函数是:CryptoJS.AES.decrypt，CryptoJS.DES.decrypt，CryptoJS.Rabbit.decrypt，CryptoJS.RC4.decrypt，CryptoJS.TripleDES.decrypt，

其中最常用的是 CryptoJS.AES.decrypt。

其中可选参数对象常用属性：

mode：加密模式【CBC ECB CFB OFB CTRGladman(CTR)】，默认为CBC
paddig：填充方式【 NoPadding ZeroPadding Pkcs7(Pkcs5) Iso10126 Iso97971 AnsiX923】，默认为Pkcs7(Pkcs5)
vi：偏移向量
formatter：自定义格式

// 导入加密包 crypto-js
var CryptoJS = require("crypto-js");

// 设置密钥
var key = CryptoJS.enc.Hex.parse("000102030405060708090a0b0c0d0e0f");

// 设置偏移量
var iv = CryptoJS.enc.Hex.parse("101112131415161718191a1b1c1d1e1f");

// 加密
var encrypted = CryptoJS.AES.encrypt("Message", 
                                     key, 
                                     {
    
     mode: CryptoJS.mode.CFB,
                                      padding: CryptoJS.pad.AnsiX923,
                                     iv: iv });

// 解密, 返回的是 CipherParams 对象
var decrypted = CryptoJS.AES.decrypt(encrypted,
                                     key,
                                    {
    
     mode: CryptoJS.mode.CFB,
                                      padding: CryptoJS.pad.AnsiX923,
                                     iv: iv });

// 获取解密字符串
var decryptString = decrypted.toString(CryptoJS.enc.Utf8);

运行效果如下：

（4）接口关联

通过全局变量、环境变量或集合变量来存储不同层级作用域的变量，通过此变量将需要传递的值(如token、sessionid、用户/商品id等使接口有变量依赖的数值)在不同的接口之间传递依赖，以达到接口关联的目的。

1.3 运行测试集

接口调试通后，即可通过Runner来选择运行同一Collection/Folder下的多个接口，可以运行Collection/Folder多次，但运行是串行迭代的，并不是并发测试。操作步骤如下：

运行结果/测试报告

在上图中，点击View summary查看报告汇总，以查看各接口在各迭代中的通过情况，知晓接口的成功率及稳定性：

（1）使用newman生成测试报告

安装 npm环境，nods安装包见官网：http://nodejs.cn/download/；

安装newman, cnpm install -g newman，常用命令如下：

newman run [collection.json/分享的链接] [-g 全局变量文件.json] [-e 环境变量文件.json] [-r 报告格式] [--reporter-html-export 生成的报告保存路径] [-n num]
[]中的值表示可选
-r 报告格式:能指定的报告格式有cli、html
-n num:运行集合num次

导出在Postman中调试好的自动化脚本，导出的文件类型为json文件：
- 如果有环境变量、全局变量，则亦需将之分别导出，导出的文件类型亦为json文件：
- 在CMD中运行结果如下：
输出为cli格式时，会先输出各接口测试明细，再显示集合运行概览和失败的接口断言详情：

输出为HTML时，CMD页面不会有任何输出，直接到对应指定的路径下找报告即可：