postman作为一款发送HTTP请求的应用工具,在开发和测试过程中调试HTTP接口有着很大的作用,这里分享通过postman完成一个小型项目接口自动化测试的文章。
一、基本功能介绍
1、下载安装:可以直接安装 Chrome浏览器的插件或者是下载postman 客户端,使用统一的账号登陆就能使数据同步。
2、发送请求:
我们常用GET/POST/DELETE …类型的http请求,在postman中只需填写对应的填写URL,HEARDER,BODY等内容就可以发送请求并看到接口请求的结果。下图简单展示一个接口返回的界面和常用功能:
3、settings—General 设置postman的系统设置,例如主题背景快捷键等。
4、code:我们可以将postman中对接口调试的结果直接导出成想要的代码:
5、关于参数:
Form-data 传参 form-data是web表单默认的传输格式,编辑器允许你通过设置key-value形式的数据来模拟填充表单。你可以在最后的选项中选择添加文件。
x-www-form-urlencoded传参 这个编码格式同样可以通过设置key-value的方式作为URL的参数。
raw 传参 一个raw请求可以包含任何内容。在这里可以设置我们常用的JSON 和 XML数据格式。
binary 传参 在这里你可以发送视频、音频、文本等文件。
查看相应:
Postman的body标签中有三种查看方式:Pretty、Raw、Preview
Pretty方式,可以让JSON 和 XML的响应内容显示的更美观规整。
显示最原始的数据,可以帮助你判断是否minified
可以帮你把HTML页面自动解析显示出来。
6、参数化
对于一条完整的测试数据的场景构建,我们可以使用{{name}}参数化来传递,比如接口B依赖接口A返回的字段data_1,那么我们使用如下语句进行传递:
在接口A的Tests脚本中添加:
var rsp=JSON.parse(responseBody);
postman.setEnvironmentVariable("data_1",rsp.data.data_1); //将response返回的data_1存为当前环境变量data_1
在接口B中调用data_1:
data = {{data_1}}
7、常用概念
1、同步cookie:可以使用Chrome浏览器已经登录的cookie,同步浏览器的cookie需要安装另一个插件Interceptor(拦截机)。它可以在你发送请求时帮你将已经存在于浏览器的数据随header请求,另外它可以将浏览器的请求写到postman的历史中(需要开启“Request Capture”)。
2、集合
集合不单单只有分类和存储功能,Postman支持一键运行整个集合内的测试。
我们可以把一个请求当做一个Test Case, 那么集合就是一个Test Suite。
每个集合都对应一个URL,可以通过Share按钮获得你的集合URL,这个URL可以用于分享给你的队友,或者用于Newman执行。
Newman是Postman的一个命令行工具,可以让API测试加入到你的持续集成任务上。
3、环境变量
当做API测试时,你可能经常需要切换不同的设置。比如,开发环境的API设置、测试环境和产品环境的API设置,你可能需要在不同的测试环境下使用不同的配置。为此Postman提供了环境变量,这样你就可以通过修改环境变量,而不需修改请求了。
你可以通过右上角的下拉菜单选择环境,可以通过点击右侧的小眼睛来查看当前环境变量。
8、接口自动化测试
首先,Postman测试沙箱是一个JavaScript执行环境,可以通过JS脚本来编写pre-requist和测试脚本。pre-requist可以用来修改一些默认参数。
postman执行接口请求分为以下三个部分:
1、在发起请求之前运行的Pre-request,预处理数据,作用:在发送请求前编辑请求数据,比如用户名或时间戳
2、对响应后的数据运行的Test,检查数据并做断言,作用:对响应的数据检查和断言,例如检查状态码、检查响应串、验证JSON、检查header、限制应答时间
3、批量运行所有请求的Collection Runner,批量执行接口测试
然后,我们选择需要运行的测试集和测试数据,run之后可以看到测试报告。
最后查看本次的测试报告,根据报告结果跟进具体问题:
9、Jenkins集成
我们知道Jenkins可以用来做持续集成,需在安装Jenkins的机器上同时安装Newman ,并且将我们的测试集的数据放在git管理,在jenkins的Shell脚本命令中指定每次执行最新的代码去run ,就可以实现最简单的接口自动化测试。
1、安装Newman ,先安装node.js
brew -v
brew install node
Node -v 或者 brew list
2、node.js 安装成功之后 安装Newman
npm install -g newma
3、运行命令 本地/报告
这里我们将需要运行的测试集合导出到本地,命名为Hippo.postman_collection
使用Newman 常用的运行命令有:
newman -c /Users/aoxiaowen/Desktop/Hippo.postman_collection //其中 -c 后面的参数为postman_collection文件的本地路径
newman run --reporters html /Users/aoxiaowen/Desktop/Hippo.postman_collection --reporter-html-export htmlOutput.html --export-online //选择测试报告的格式,指定当前运行的环境
newman run /Users/aoxiaowen/Desktop/Hippo.postman_collection.json -e /Users/aoxiaowen/Desktop/Hippo.postman_environment.json --reporters html --reporter-html-export /Users/aoxiaowen/postmanfile/result.html //使用本地json测试数据
newman run /Users/aoxiaowen/Downloads/testData.postman_collection -e /Users/aoxiaowen/Downloads/online.postman_environment -g /Users/aoxiaowen/Desktop/test.csv --folder testData --reporters html --reporter-html-export /Users/aoxiaowen/postmanfile/result.html //使用本地csv测试数据
这种自动化的测试一般适用于小型的简单测试,本身的接口collection可以方便于我们日常的测试收集。