Postman Pre-request Script

这个其实是普通的js脚本，有一些和postman的通信他也提供了一些快捷命令如下

postman常用参数使用

环境变量

//设置当前环境变量
pm.environment.set("key", "value");
//获取当前环境变量
pm.environment.get("key");
//清除当前环境变量
pm.environment.unset("key");
//设置全局环境变量
pm.globals.set("key", "value");
//获取全局环境变量
pm.globals.get("key");
//清除全局环境变量
pm.globals.unset("key");
//在全局和当前环境变量中获取
pm.variables.get("key");
//设置集合
pm.collectionVariables.set("key",["value1","value2","value3"])
//获取集合
pm.collectionVariables.get("key");
//清除集合
pm.collectionVariables.unset("key");
//遍历集集合，遍历function(遍历当前值,索引,集合,)
pm.collectionVariables.get("key").forEach(function(a,b,c){
console.log(a);
console.log(b);
console.log(c);
});

查询字符串

//获取当前请求方式,返回:string
var method = pm.request.method;
//输出当前请求信息,返回:json
var request = pm.request.toJSON();
//输出当前请求url,返回:string
var url = pm.request.url.toString();
//输出当前请求参数,参数(是否编码):true  false ,返回:string
var querypararm =  pm.request.url.getQueryString(false);
//获取请求参数,参数(请求的键值)(string 类型),返回:string
var value = pm.request.url.query.get("key_name");
//删除请求参数,参数(请求的键值)
pm.request.url.query.remove("key_name");
//添加请求参数,参数(添加请求参数),数组类型
pm.request.url.query.add("key1=value1","key2=value2");
//判断某个键值是否存在,返回:boolean
var has = pm.request.url.query.has("key");

内置请求

//定义请求信息
var requests = {
     url:url,//请求url
     method: 'POST',//请求方式
     header: {'Content-Type':'application/json'},//请求header
     body: {
     mode: 'raw',//数据模型
     raw: JSON.stringify({mobile:raw.mobile,useScene:"login"})//数据
  }
 };

//发送请求,参数:请求信息,响应函数(异常,响应数据)
 pm.sendRequest(requests,function (err, response) {
      var result = response.json();
      console.log(result);
   
 });

请求头

//获取所有headers
var header = pm.request.getHeaders();
//移除header
pm.request.removeHeader("key");
//添加header
pm.request.addHeader("key:value");

请求体

//获得body中的内容,返回:string
 var body = pm.request.body.raw;
//重新设置body内容,参数:string
 pm.request.body.update("");
//添加param参数,参数:string或者QueryParam对象
pm.request.addQueryParams("key=value");
//移除para参数,参数:数组字符串
pm.request.removeQueryParams("1","2");

Cookies

值得注意的是必须把这个domain添加到 cookies -> Manage Cookies -> Domains Allowlist 中，否则cookie的注入无效，你可以添加一个很广泛的域名比如.com来实现对所有的允许，但是建议使用精确

https://learning.postman.com/docs/sending-requests/response-data/cookies/#get-a-cookie

//创建一个cookie容器
const cookieJar = pm.cookies.jar();

//设置cookie,参数: url,cookieName,cookieValue,回调函数function(异常,设置成功的cookie)
/**
 * 如果设置失败,提示如下:Unable to access "xxxx.com" cookie store. Try    whitelisting the domain in "Manage Cookies 
 * 点击界面的 Cookies > Domains Allowlist(左下角) > 在输入框中加入xxxx.com 点击
 * add
 */
cookieJar.set("xxxx.com","name","value",function(error,cookie){
console.log(error);
console.log(cookie);
})

//获取cookie,参数: url,cookieName,回调函数function(异常,cookie)
cookieJar.get("xxxx.com","name",function(error,cookie){
console.log(error);
console.log(cookie);
})

//获取所有cookie,参数: url,回调函数function(异常,cookie)
cookieJar.getAll("xxxx.com", function(error, cookies){
console.log(error);
console.log(cookie);
});

//删除cookie,参数: url,cookieName,回调函数function(异常)
cookieJar.unset("xxxx.com", "name", function(error){
console.log(error);
});

//删除所有cookie,参数: url,回调函数function(异常)
cookieJar.clear("xxxx.com", "name", function(error){
console.log(error);
});

工具

//字符串转json对象
var json =JSON.parse("");

//json对象转字符串
var string = JSON.stringify(obj);

//获取当前时间的时间格式
var time = require('moment')().format("YYYY-MM-DD HH:mm:ss");

//参数编码参数
var encodeURI = encodeURIComponent("");

//编码整个url
var encodeURI = encodeURI("");

//base64编码
var content = CryptoJS.enc.Utf8.parse("1");
var base64Content = CryptoJS.enc.Base64.stringify(content);

//base64解码
var parsedWordArray = CryptoJS.enc.Base64.parse(base64Content);
var wordString = parsedWordArray.toString(CryptoJS.enc.Utf8);

//xml转换json对象,参数：请求响应的xml
var jsonObject = xml2Json(responseBody);

//解析响应的csv
const parse = require('csv-parse/lib/sync');
const responseJson = parse(pm.response.text());

//解析html
const $ = cheerio.load(pm.response.text());
console.log($.html());

//MD5加密
var md5 = CryptoJS.MD5("").toString();

//SHA1加密
var sha1 = CryptoJS.SHA1("").toString();

//AES加密
const keys = CryptoJS.enc.Utf8.parse("123456789");//秘钥
const ivs = CryptoJS.enc.Utf8.parse('tltlaycvtweasa');//偏移量
let encryptedWord = CryptoJS.enc.Utf8.parse("1");//加密内容
var encrypted = CryptoJS.AES.encrypt(encryptedWord, keys, { iv: ivs,mode:CryptoJS.mode.CBC, padding: CryptoJS.pad.Pkcs7}); //加密结果
var ciphertext = encrypted.toString(); //密文

Tests编写

值获取

//请求耗时
var time = pm.response.responseTime;
//获取响应code
var code = pm.response.code;
//获取错误描述:例如返回200,下面返回的是OK
var status = pm.response.status;
//获取响应数据
var data = pm.response.json();
//获取响应header
var header = pm.response.headers.get("key");

模板判断

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


//断言响应是否等于指定字符串
pm.test("断言响应是否等于指定字符串", function () {
    pm.response.to.have.body("指定字符串");
});
 

//断言json值是否等于指定值
pm.test("断言json值是否等于指定值", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.value).to.eql(100);
});

//断言是否存在Content-Type标头
pm.test("断言是否存在Content-Type标头", function () {
    pm.response.to.have.header("Content-Type");
});

//断言cookie是否存在
pm.test("断言cookie是否存在", () => {
  pm.expect(pm.cookies.has('JSESSIONID')).to.be.true;
});

//断言cookie是否等于特定值
pm.test("断言cookie是否等于特定值", () => {
  pm.expect(pm.cookies.get('JSESSIONID')).to.eql('1');
});

//断言响应时间小于200ms
pm.test("断言响应时间小于200ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(200);
});

//断言状态码为200
pm.test("断言状态码为200", function () {
    pm.response.to.have.status(200);
});


//断言状态响应说明是否包指定值
pm.test("断言状态响应说明是否包指定值", function () {
    pm.response.to.have.status("Created");
});

//断言成功响应状态码,oneOf表示在一组值中
pm.test("断言成功响应状态码", function () {
    pm.expect(pm.response.code).to.be.oneOf([201,202]);
});

//断言环境值和响应回来的值
pm.test("断言环境值和响应回来的值", function () {
  pm.expect(pm.response.json().name).to.eql(pm.environment.get("name"));
});

//断言响应数据类型
/* 响应数据结构如下
{
  "name": "Jane",
  "age": 29,
  "hobbies": [
    "skating",
    "painting"
  ],
  "email": null
}
*/
const jsonData = pm.response.json();
pm.test("Test data type of the response", () => {
  pm.expect(jsonData).to.be.an("object");//是否为对象类型
  pm.expect(jsonData.name).to.be.a("string");//是否为字符串类型
  pm.expect(jsonData.age).to.be.a("number");//是否为数字类型
  pm.expect(jsonData.hobbies).to.be.an("array");//是否为数组
  pm.expect(jsonData.website).to.be.undefined;//是否未定义
  pm.expect(jsonData.email).to.be.null;//是否为null
});

//断言数组
/* 响应数据结构如下
{
  "errors": [],
  "areas": [ "goods", "services" ],
  "settings": [
    {
      "type": "notification",
      "detail": [ "email", "sms" ]
    },
    {
      "type": "visual",
      "detail": [ "light", "large" ]
    }
  ]
}
*/
const jsonData = pm.response.json();
pm.test("Test array properties", () => {
    //判断是否为空
  pm.expect(jsonData.errors).to.be.empty;
    //判断是否包含 "goods"
  pm.expect(jsonData.areas).to.include("goods");
    //判断 settings 中的object是否有type='notification'
  const notificationSettings = jsonData.settings.find
      (m => m.type === "notification");
  pm.expect(notificationSettings)
    .to.be.an("object", "Could not find the setting");
    //判断是否notificationSettings.detail中是否包含"sms"
  pm.expect(notificationSettings.detail).to.include("sms");
    //判断是否notificationSettings.detail中是否包含如下所有成员
  pm.expect(notificationSettings.detail)
    .to.have.members(["email", "sms"]);
});

//断言一个对象包含键或属性
//断言包含所有的key
pm.expect({a: 1, b: 2}).to.have.all.keys('a', 'b');
//断言包含任何一个成员
pm.expect({a: 1, b: 2}).to.have.any.keys('a', 'b');
//断言不包含任何一个成员
pm.expect({a: 1, b: 2}).to.not.have.any.keys('c', 'd');
//断言是否包含a属性
pm.expect({a: 1}).to.have.property('a');
//断言值是否为object对象,并且包含所有的key
pm.expect({a: 1, b: 2}).to.be.an('object')
  .that.has.all.keys('a', 'b');

//TV4校验

//定义校验模型,要求值为boolean类型
var schema = {
 "items": {
 "type": "boolean"
 }
};
//定义测试数据
//满足要求
var data1 = [true, false];
//不满足要求
var data2 = [true, 123];
//校验TV4模型
pm.test('校验TV4模型', function() {
  pm.expect(tv4.validate(data1, schema)).to.be.true;
  pm.expect(tv4.validate(data2, schema)).to.be.true;
});


//JSON模型校验

//构建Ajv
var Ajv = require('ajv');
//初始化
var ajv = new Ajv({logger: console})
//定义规则
var schema = {
        "properties": {
            "alpha": {
                "type": "boolean"
            }
        }
    };
//定义测试数据
//符合规则
var test1 = {alpha: true};
//不符合规则
var test2 = {alpha: 123};
//校验
pm.test('JSON模型校验', function() {
    pm.expect(ajv.validate(schema, test1)).to.be.true;
    pm.expect(ajv.validate(schema, test2)).to.be.false;
});



//将请求结果可视化
//数据样例
/**
 [
    {
        "name": "Alice",
        "email": "alice@example.com"
    },
    {
        "name": "Jack",
        "email": "jack@example.com"
    },
    // ... and so on
]
*/
//数据模板
var template = `
    <table bgcolor="#FFFFFF">
        <tr>
            <th>Name</th>
            <th>Email</th>
        </tr>

        {{#each response}}
            <tr>
                <td>{{name}}</td>
                <td>{{email}}</td>
            </tr>
        {{/each}}
    </table>
`;
//填充数据模板
pm.visualizer.set(template, {
    response: pm.response.json()
});

动态变量

获取动态变量

//动态变量获取
pm.variables.replaceIn('{{$randomFirstName}}');

常见动态变量的选择

具体文档链接：https://learning.postman.com/docs/tests-and-scripts/write-scripts/variables-list/

变量名	描述	例子
$guid	一个uuid-v4风格GUID	“611c2e81-2ccb-42d8-9ddc-2d0bfa65c1b4”
$timestamp	当前UNIX时间戳（以秒为单位）	1562757107
$isoTimestamp	当前ISO时间戳（UTC为零）	2020-06-09T21:10:36.177Z
$randomUUID	随机的36个字符的UUID	“6929bb52-3ab2-448a-9796-d6480ecad36b”
$randomAlphaNumeric	随机字母数字字符	6，“y”，“z”
$randomBoolean	随机布尔值（真/假）	true，false，false，true
$randomInt	1至1000之间的随机整数	802，494，200

demo

这是一个注入csrf的脚本，
在package中编写

然后在需要的接口的script中引入


也可以给整个collection的script添加，那么这个目录下的所有接口都共用这个脚本

官方文档

https://learning.postman.com/docs/tests-and-scripts/write-scripts/intro-to-scripts/