Postman断言写法以及脚本pm对象

Lary_c2024-08-22 15:08

pm对象

pm对象包含与正在执行的脚本有关的所有信息，并允许访问正在发送的请求的副本或接受到的响应，它还允许获取和设置环境变量和全局变量

pm.info对象

pm.info对象包含与正在执行的脚本有关的信息，如请求名称、请求ID和迭计数等有用信息储存在该对象中

方法 描述
pm.info.eventName 输出脚本是在哪个脚本栏中执行的
pm.info.iteration 输出当前运行迭代的次数(从0开始)
pm.info.iterationCount 输出计划运行的迭代总数
pm.info.requestName 返回请求名
pm.info.requestId 返回请求ID

pm.sendRequest对象

pm.sendRequest对象允许异步发送HTTP/HTTPS请求。pm.sendRequest()方法接收两个参数，一个URL(请求信息)和一个函数；函数又接收两个参数：第一个URL参数的响应(错误和正确响应)，Postman内部将第一个URL参数的响应赋值给两个变量err,res(即err,res就是脚本请求的错误响应或正确响应，如果要对脚本请求的响应进行处理的话，就可以使用err,res来处理)

发送请求并进行断言

js 复制代码 
pm.sendRequest("url",function(err,res){
    if(err){
        console.log(err);
    }else{
        pm.test("断言描述",function(){
            pm.expect(err).to.equal(null);
            pm.expect(res).to.have.property("code",200);
        })
    }
})

pm.globals对象

方法 描述
pm.globals.has("variableName") 验证是否存在该全局变量
pm.globals.get("variableName") 获取执行全局变量的值
pm.globals.set("variableName","variableValue") 设置全局变量
pm.globals.unset("variableName") 清除指定的全局变量
pm.globals.clear() 清除全部全局变量
pm.globals.toObject() 将全局变量以一个对象的方式全部输出

pm.environment对象

方法 描述
pm.environment.has("variableName") 检测环境变量是否包含某个变量
pm.environment.get("variableName") 获取环境变量中的某个值
pm.environment.set("variableName","variableValue") 为某个环境变量设置值
pm.environment.unset("variableName") 清除某个环境变量
pm.environment.clear() 清除全部环境变量
pm.environment.toObject() 将环境变量以一个对象的方式全部输出

pm.request对象

方法 描述
pm.request 获取当前发起请求的全部headers
pm.request.url 获取当前发起请求的url
pm.request.headers 以数组的方式返回当前请求中的header信息

pm.response对象

方法 描述
pm.response.code 获取当前请求返回的状态码如200,404,500等
pm.response.reason() 当前请求成功返回OK
pm.response.headers 以数组的形式返回当前请求成功后的response的headers
pm.response.responseTime 获取执行此次请求的时间单位为ms
pm.response.text() 以文本的方式获取响应里面的body的内容
pm.response.json() 将body里面的内容解析为一个json对象

pm.cookies对象

pm.cookies对象包含一个与请求所创建的域相关联的Cookies列表

方法 描述
pm.cookies.has("cookieName") 检查请求的url站点是否存在cookie，返回值Boolean
pm.cookies.get("cookieName") 获取存在的cookie的值
pm.cookies.toObject() 将请求的url站点中获取到的所有存在的cookie输出到一个对象中去

Postman中的Test

在Postman中用于测试、断言的函数主要有如下

方法 描述
pm.test("testName",specFunction) 测试方法，第二个方法中填写测试内容
pm.expect(assertion:*) 断言

pm.test()方法用于创建一个测试。接受两个参数，一个是测试的相关描述，另外一个是一个回调函数，用来执行断言相关的语句

pm.expect是一个通用的断言函数。用来处理响应或变量的数据断言。

e.g

js 复制代码 
pm.test("status code is 200",function(){
    pm.response.to.have.statue(200);
})

pm.response.to.be 对象

Postman提供的测试脚本响应断言包含以下API：pm.response.to

方法 描述
pm.response.to.have.status(code:Number) 判断响应结果是否包含指定的状态码
pm.response.to.have.status(reason:String) 判断响应结果是否包含指定的状态描述
pm.response.to.have.header(key:String) 判断响应结果是否包含指定的头部字段
pm.response.to.have.header(key:String,optionalValue:String) 判断响应结果是否包含指定的头部字段和值
pm.response.to.have.body() 判断响应结果是否包含消息体
pm.response.to.have.body(optionalValue:String) 判断响应结果是否包含指定的字符串
pm.response.to.have.body(optionalValue:RegExp) 判断响应结果是否包含指定的符合正则表达式规则的字符串
pm.response.to.have.jsonBody() 判断响应结果是否包含 json 格式的消息体
pm.response.to.have.jsonBody(optionalExpectEqual:Object) 判断响应结果是否包含指定对象的 json 格式消息体
pm.response.to.have.jsonBody(optionalExpectPath:String) 判断响应结果是否包含指定层级的 json 格式消息体
pm.response.to.have.jsonBody(optionalExpectPath:String, optionalValue:*) 判断响应结果是否包含指定路径并且值也匹配的 json 格式消息体
pm.response.to.have.jsonSchema(schema:Object) 判断响应结果是否符合指定的 json 结构；schema 参数是以对象形式描述的 json 结构
pm.response.to.have.jsonSchema(schema:Object, ajvOptions:Object) 判断响应结果是否符合指定的 json 结构；schema 参数是以对象形式描述的 json 结构并且附加 ajv 库的操作

e.g

js 复制代码 
var json = {
    "access_token" : String,
    "expires_in":String
}

pm.test("响应体的结构符合", function(){
    pm.response.to.have.jsonSchema(json)
})

测试脚本中的响应断言API

Postman常用的八种断言写法

js 复制代码 
pm.test("检查返回状态码为200",function(){
    pm.response.to.have.status(200);
})
js 复制代码 
pm.test("检查返回的结果中包含指令字符串",function(){
    //响应体body是否包含access_token
    pm.expect(pm.response.test()).to.include("access_token");
})
js 复制代码 
pm.test("检查json中其中一个字段的值"，function(){
    var jsonData = pm.response.json();
    pm.expect(jsonData.字段名).to.eql(7200);
})
js 复制代码 
pm.test("检查返回的值等于一个指定的字符串",function(){
    pm.response.to.have.body('{"errcode":0,"errmsg":"ok"}');
})
js 复制代码 
pm.test("检查是否包含响应头Content-Type",function(){
    pm.response.to.have.header("Content-Type")
})
js 复制代码 
pm.test("检查请求耗时小于300ms",function(){
    pm.expect(pm.response.responseTime).to.be.below(300);
})
js 复制代码 
pm.test("检查返回的状态码是否在数组中",function(){
    pm.expect(pm.response.code).to.be.oneOf([200, 202]);
})
js 复制代码 
pm.test("检查状态信息是指定的字符串",function(){
    pm.response.to.have.status("OK")
})

附录

js 复制代码 
// console.log(responseBody);
// var jsobj = JSON.parse(responseBody)
// // console.log(jsobj.access_token)
// pm.globals.set("token", jsobj.access_token);  

// pm.test("检查返回的结果中包含token字符串", function () {
//     pm.expect(pm.response.text()).to.include("access_token");
// });

// console.log("response:",pm.response)
// console.log("request:",pm.request);
// pm.test("Response time is less than 200ms", function () {
//     pm.expect(pm.response.responseTime).to.be.below(200);
// });

//  输出脚本是在哪个脚本栏中执行的
// console.log(pm.info.eventName);

//  输出当前运行迭代的次数(从0开始)
// console.log(pm.info.iteration)

// 输出计划运行的迭代总数
// console.log(pm.info.iterationCount)

// 返回请求名
// console.log(pm.info.requestName)

// 返回请求ID 
// console.log(pm.info.requestId)

// 验证是否存在此全局变量
// console.log(pm.globals.has("token"))

// 获取该全局变量的值
// console.log(pm.globals.get('token'))

// 设置全局变量
// pm.globals.set("token","value")

// 清除指定的全局变量
// pm.globals.unset("token");

// 清除全部的全局变量
// pm.globals.clear();

// 将全局变量以一个对象的方式全部输出
// console.log(pm.globals.toObject());

// 检测环境变量是否包含某个变量
// console.log(pm.environment.has("test"));

// 获取环境变量中的某个值
// console.log(pm.environment.get("test"))

// 为某个环境变量设置值
// pm.environment.set("test","testValue");

//  清除某个环境变量
// pm.environment.unset("test");

// 清除全部环境变量
// pm.environment.clear();

// 将环境变量以一个对象的方式全部输出
// console.log(pm.environment.toObject());

// pm.request对象
// console.log(pm.request)

// 获取当前发起请求的url
// console.log(pm.request.url)

// 以数组的方式返回当前请求中的header信息
// console.log(pm.request.headers)

// pm.response对象
// console.log(pm.response);

// 获取当前请求返回的状态码
// console.log(pm.response.code)

// 当前请求成功返回OK
// console.log(pm.response.reason())

// 以数组的形式返回当前请求成功后的response的headers
// console.log(pm.response.headers)

// 获取执行此次请求的时间单位为ms
// console.log(pm.response.responseTime)

// 以文本的方式获取响应里面的body的内容
// console.log(pm.response.text())

// 将body里面的内容解析为一个json对象
// console.log(pm.response.json());

// pm.cookies对象
// console.log(pm.cookies)

// 检查请求的url站点是否存在cookie，返回值Boolean
// console.log(pm.cookies.has("cookieName"))

// 获取存在的cookie的值
// console.log(pm.cookies.get("cookieName"));

// 将请求的url站点中获取到的所有存在的cookie输出到一个对象中去
// console.log(pm.cookies.toObject("cookieName"))


// 检测响应体的结构是否正常
/*
var json = {
    "access_token" : String,
    "expires_in":String
}

pm.test("响应体的结构符合", function(){
    pm.response.to.have.jsonSchema(json)
})
*/
相关推荐
Serendipity_筱楠14 小时前
Windows安装部署jenkins
windows·ci/cd·自动化·jenkins·测试
cyc&阿灿2 天前
深度解析SpringBoot自动化部署实战：从原理到最佳实践
spring boot·后端·自动化
咧咧小侠2 天前
群控 iPhone（免越狱）自动化系统搭建构想
自动化·cocoa·iphone
FF-Studio2 天前
【DSP笔记 · 第5章】数字滤波器的蓝图：从数学公式到硬件实现的艺术
笔记·fpga开发·自动化·音视频·音频·信号处理
宇钶宇夕2 天前
电路图识图基础知识-行程开关自动往返运行控制电路详解（二十三）
运维·自动化
chatblog2 天前
Hugo 自动化部署实战-部署 Hugo 到 Netlify
运维·自动化·github
2501_915374352 天前
LangChain自动化工作流实战教程：从任务编排到智能决策
python·langchain·自动化
勇太的数分之旅2 天前
Excel大厂自动化报表实战(互联网金融-数据分析周报制作下)
信息可视化·金融·数据分析·自动化·excel·数据可视化
FJSAY2 天前
我自己动手写了一个MySQL自动化备份脚本，基于docker
mysql·docker·自动化
FF-Studio2 天前
万物皆数：构建数字信号处理的数学基石
算法·数学建模·fpga开发·自动化·音视频·信号处理·dsp开发
热门推荐
01Coze扣子平台完整体验和实践（附国内和国际版对比）02DeepSeek各版本说明与优缺点分析03KGG转MP3工具|非KGM文件|解密音频04扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解05零代码入门 | Coze——让大模型接入自己的数据库06从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑07扣子空间的使用教程与大模型技术思考08YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】09【SpeedAI科研小助手】2分钟极速解决知网维普重复率、AIGC率过高，一键全文降！文件格式不变，公式都保留的！10AI Agent | Coze 插件使用指南：从功能解析到实操步骤