草庐IT

Postman实现接口测试(附项目实战)

Archie_java 2023-04-19 原文

文章目录

Postman实现接口测试

    1. 掌握如何安装Postman
    1. 掌握Postman的基本用法
    1. 掌握全局变量与环境变量
    1. 掌握Postman断言和关联
    1. 掌握如何读取外部文件实现参数化
    1. 掌握如何使用Newman生成HTML测试报告

1.Postman介绍和安装

Postman是一款非常流行的接口调试工具,它使用简单,而且功能也很强大。不仅测试人员会使用,开发人员也会 经常使用。

官方网站:https://www.getpostman.com/

主要特点

    1. 简单易用的图形用户界面
    1. 可以保存接口请求的历史记录
    1. 使用测试集Collections可以更有效的管理组织接口
    1. 可以在团队之间同步接口数据

2. Postman安装

2.1 安装方式

  • 方式一: Postman最早是以Chrome浏览器插件的形式存在的,可以到chrome商店搜索下载安装。由于2018年初Chrome停止对Chrome应用程序的支持,所以不再推荐使用该方式。
  • 方式二:Postman提供了独立的安装包,不再依赖于Chrome浏览器了。同时支持MAC、Windows和Linux,推荐使用这 种方式安装。
  • 下载地址:https://www.getpostman.com/apps

2.2 安装步骤

Windows

  • 双击运行安装程序,即可完成安装。

MacOS

  • 下载的应用程序,你可以拖动文件到“应用程序”文件夹。

3. Postman入门示例

需求

使用Postman访问百度 http://www.baidu.com ,并查看响应结果

实现步骤

    1. 设置请求方式
    1. 输入接口地址
    1. 点击发送请求
    1. 查看响应结果

示例截图

Postman基本用法

    1. 掌握使用Postman发送URL参数
    1. 掌握使用Postman发送表单数据
    1. 掌握使用Postman发送JSON数据

1.案例一

1.1 需求

  • 访问TPshop搜索商品的接口,通过查询字符串的方式传递搜索的关键字 iPhone ,并查看响应数据
  • 请求路径格式为: http://localhost/Home/Goods/search.html?q=iPhone

1.2 实现分析

  • 请求方式:GET
  • 请求路径: http://localhost/Home/Goods/search.html
  • 传参方式:查询字符串(q=iPhone)

1.3 实现步骤

  1. 设置请求方式为GET
  2. 输入请求路径
  3. 设置请求数据(查询字符串)
  4. 点击发送请求
  5. 查看响应数据

1.4 示例截图

2.案例二

2.1 需求

  • 请求TPshop项目的登录接口,请求数据(username: 13088888888, password: 123456, verify_code: 1234)
  • 登录接口URL:http://localhost/index.php?m=Home&c=User&a=do_login

2.2 实现分析

  • 请求方式:POST
  • 请求路径: http://localhost/index.php?m=Home&c=User&a=do_login 请求数据:请求体-表单提交(username: 13088888888, password: 123456, verify_code: 1234)

2.3 实现步骤

  1. 设置请求方式为POST
  2. 输入请求路径
  3. 设置请求数据(请求体-表单提交)
  4. 点击发送请求
  5. 查看响应数据

2.4 示例截图

3.案例三

3.1 需求

    1. 请求IHRM项目的登录接口,请求数据( {“mobile”:“13800000002”, “password”:“123456”} )
    1. 登录接口URL:http://182.92.81.159/api/sys/login

3.2 实现分析

  • 请求方式:POST
  • 请求路径: http://182.92.81.159/api/sys/login
  • 请求数据:
    • 请求头-(Content-Type: application/json)
    • 请求体-JSON数据( {“mobile”:“13800000002”, “password”:“123456”} )

3.3 实现步骤

  1. 设置请求方式为POST
  2. 输入请求路径
  3. 设置请求头
  4. 设置请求体(请求体-raw)
  5. 点击发送请求
  6. 查看响应数据

3.4 示例截图

设置请求头:

设置请求体:

Postman高级用法

    1. 掌握如何创建用例的目录结构
    1. 掌握Postman断言
    1. 掌握全局变量与环境变量
    1. 掌握Postman关联
    1. 掌握如何读取外部文件实现参数化

1. 管理用例

思考:针对一个大型的项目进行接口测试,会编写很多测试用例。怎么更好的管理维护测试用例呢?

1.1 实现步骤

  • 创建测试集-New Collection
    • Collection可以理解成一个项目(系统),包含多个接口请求
  • 创建目录-Add Folder
    • Folder可以理解成一个项目模块
  • 添加请求-Add
    • Request

1.2 实现步骤截图

1)创建测试集- 点击‘New Collection’,在弹出框中输入测试集的名称和其他信息,再点击‘Create’按钮

2)创建目录- 在测试集上点击右键选择‘Add Folder’,在弹出框中输入目录的名称和其他信息,再点击‘Create’按 钮

3.)添加请求- 在目录上点击右键选择‘Add Request’,在弹出框中输入请求的名称和其他信息,再点击保存按钮

2. Postman断言

断言:让程序判断预期结果和实际结果是否一致。

2.1 特点

  • Postman的断言是使用JavaScript语言编写的,写在‘Tests’标签页里
  • Tests中的脚本在发送请求之后执行,会把断言的结果(PASS/FAIL)最终在‘Test Results’标签页中展示

2.2 常用Postman断言

选择断言代码片段

在Tests输入框的右侧配置了一些常用的断言代码片段,点击后自动填写到Tests输入框中,然后再进行修改

断言代码片段介绍

1.Status code: Code is 200

// 判断响应状态码是否等于200
pm.test("Status code is 200", function () {
 
pm.response.to.have.status(200); });

2.Response body: Contains string

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

3.Response body: Is equal to a string

// 判断响应体数据是否等于指定的字符串 
 
pm.test("Body is correct", function () {
 
pm.response.to.have.body("response_body_string"); });

4.Response body: JSON value check

// 校验响应的JSON数据
pm.test("Your test name", function () {
 
var jsonData = pm.response.json();
 
pm.expect(jsonData.value).to.eql(100); });

5.Response headers: Content-Type header check

// 判断响应头中是否包含指定的头标签 
 
pm.test("Content-Type is present", function () {
 
pm.response.to.have.header("Content-Type"); });

测试结果

3. 全局变量与环境变量

3.1 概念

  • 全局变量:全局变量是全局唯一的,不可重复定义的变量
  • 环境变量:
    • 一个变量只能属于某个环境,在某一个环境中变量不可重复定义
    • 在环境与环境之间可以定义重复的变量
    • 一个环境可以包含多个环境变量
    • 常见环境分类:开发环境、测试环境、生产环境

3.2 设置变量

全局变量

    1. 手动设置
    1. 代码设置: pm.globals.set(“var_name”, value);

环境变量

    1. 手动设置
    1. 代码设置: pm.environment.set(“var_name”, value);

3.3 获取变量值

全局变量

    1. 请求参数中获取:{{var_name}}
    1. 代码中获取: var value = pm.globals.get(“var_name”);

环境变量

    1. 请求参数中获取:{{var_name}}
    1. 代码中获取: var value = pm.environment.get(“var_name”);

4.请求前置脚本

请求前置脚本就是在“Pre-request Script”标签中所编写的脚本,是在请求发送之前要执行的代码片段。 应用场景:

  • 请求参数中包含一个随机数或者时间戳
  • 请求之前需要对请求参数做进一步处理(如:对敏感参数进行加密)

案例

需求:请求TPshop项目中获取图片验证码的接口,需要在URL中设置随机数 请求路径:
分析:在JS中如何生成随机数?

实现截图

5. Postman关联

当请求之间有依赖关系,比如一个请求的入参是另一个请求返回的数据,这时候就需要用到关联处理。

5.1 如何实现?

  • 要获取某个请求的响应结果数据,可以通过在‘Tests’标签页中编写JavaScript脚本来实现
// 获取JSON格式的响应数据
var jsonData = pm.response.json();
  • 多个请求之间可以使用全局变量或环境变量来传递数据
// 把数据保存到全局变量中 pm.globals.set("city", city);
  • 获取某个全局变量的值:{{var_name}}

5.2 案例

  1. 请求获取天气的接口,http://www.weather.com.cn/data/sk/101010100.html
  2. 获取返回结果中的城市名称
  3. 调用百度搜索接口: http://www.baidu.com/s?wd=北京 ,把获取到的城市名称作为请求参数

实现步骤截图

  1. 在第一个请求的‘Tests’标签页中编写JavaScript脚本

  1. 在第二个请求中使用全局变量

6. 批量执行测试用例

要想批量执行测试用例,需要先把接口请求添加到测试集中,通过运行测试集的方式就可以实现批量运行测试用例。

操作步骤

  1. 点击测试集中的“Run”按钮,批量运行测试用例

  1. 弹出Collection Runner窗口,点击运行按钮

  1. 查看测试结果

7. 读取外部文件实现参数化

应用场景: 针对于某个接口,如果有大量的测试数据需要批量验证,可以把测试数据保存到数据文件中,通过参数化的方式来实现。
7.1 定义数据文件

常用的数据文件格式有:CSV、JSON

7.2 选择数据文件
在测试集运行“Collection Runner”窗口中,点击“Select File”按钮选择定义好的数据文件

7.3 获取数据文件中的参数

在不同的地方获取参数的方法是不同的,介绍两种获取参数的方法:

  • 请求参数可以通过{{var_name}}来引用
  • 断言中的数据,由于是在Tests中编写脚本,并不能直接通过{{var_name}}来引用,可以通过内置变量 data 来 获取
// 获取数据文件中的用户名参数 
var username = data.username;

7.4 案例

  • 需求:批量查询手机号归属地和所属运营商信息,并校验运营商数据是否正确
  • 接口地址: http://cx.shouji.360.cn/phonearea.php?number=13012345678
  • 部分测试数据:
  • 手机号: 13012345678 运营商: 联通
  • 手机号: 13800001111 运营商: 移动
  • 手机号: 18966778899 运营商: 电信

定义数据文件

  • CSV格式

phone,sp

13012345678,联通

13800001111,移动

18966778899,电信

  • JSON格式
[
{"phone":"13041092162", "sp":"联通"}, {"phone":"13820003536", "sp":"移动"}, {"phone":"18911236688", "sp":"电信"}
 
]

实现步骤截图

Postman测试报告目标

    1. 掌握如何搭建Newman的相关环境
    1. 掌握如何使用Newman生成HTML测试报告

1.Newman

Newman是一款基于nodejs开发的可以运行Postman脚本的工具,并可以生成测试报告

2.环境准备

2.1 安装nodejs

  • 下载地址:http://nodejs.cn/download/
  • 如果下载的是安装包,下载后双击安装即可
  • 如果下载的是压缩包(.zip),解压到某个目录后,需要配置环境变量
  • 校验:打开cmd,输入 node -v ,看到输出node的版本信息,即代表安装成功

2.2 安装newman

  • 1)安装newman
  • 打开cmd输入:
  • 校验:安装完成后,输入 命令查看版本信息,检测是否安装成功
  • 2)安装newman-reporter-html
  • 打开cmd输入: npm install -g newman-reporter-html

3.导出测试集数据

4.执行测试

使用newman命令,运行导出的测试集脚本,打开cmd输入:

newman run 测试脚本文件 -e 环境变量文件 -d 测试数据文件 -r html --reporter-html-export report.html
eg:
newman run demo.postman_collection.json -r html
newman run demo.postman_collection.json -r html --reporter-html-export report.html

命令说明

  • run xxx.json:表示要执行的postman脚本,即导出的测试集数据
  • -e source:用来指定环境变量文件的路径
  • -d source:用来指定测试数据文件的路径
  • -r html:用来指定生成的数据结果的类型,如json、html等
  • –reporter-html-export source:指定html报告生成的路径;如果不设置该参数,则会在当前目录下生成一个名 字为newman的文件夹

查看测试报告

命令运行完成后,打开生成的HTML文件即可看到测试报告内容

项目实战

1. 初始化工作

1.1 创建测试用例结构

1)创建测试集:IHRM人力资源管理系统

2) 创建目录

  • 登录模块
  • 员工管理模块

1.2 设置环境变量

在实际的工作中,我们既要对测试环境进行测试,也要对生产环境进行测试。

  • 测试环境

base_url=http://182.92.81.159

token=xxx

  • 生产环境

base_url=http://www.myhrm.com

token=xxx

2. 实现测试用例

根据编写的测试用例文档,使用Postman实现测试用例

2.1 登录-登录成功

操作步骤

    1. 在‘登录’目录下,添加‘登录成功’的请求
    1. 填写请求数据:请求方式、请求URL、请求头、请求体
    1. 在‘Tests’标签页中,编写测试脚本:断言、业务数据处理
    1. 发送请求,调试脚本

实现
1.添加‘登录成功’的请求

2. 填写请求数据:请求方式、请求URL

3.填写请求数据:请求头

4.编写测试脚本

5.响应体数据

6.断言结果

3. 生成测试报告

newman run 测试脚本文件 -e 环境变量文件 -d 测试数据文件 -r html --reporter-html-export report.html

操作步骤

    1. 导出测试集数据
    1. 导出环境变量数据
    1. 执行命令: newman run ihrm.postman_collection.json -e dev.postman_environment.json -r html --reporter-html-export report.html

有关Postman实现接口测试(附项目实战)的更多相关文章

  1. ruby-on-rails - 使用 Ruby on Rails 进行自动化测试 - 最佳实践 - 2

    很好奇,就使用ruby​​onrails自动化单元测试而言,你们正在做什么?您是否创建了一个脚本来在cron中运行rake作业并将结果邮寄给您?git中的预提交Hook?只是手动调用?我完全理解测试,但想知道在错误发生之前捕获错误的最佳实践是什么。让我们理所当然地认为测试本身是完美无缺的,并且可以正常工作。下一步是什么以确保他们在正确的时间将可能有害的结果传达给您? 最佳答案 不确定您到底想听什么,但是有几个级别的自动代码库控制:在处理某项功能时,您可以使用类似autotest的内容获得关于哪些有效,哪些无效的即时反馈。要确保您的提

  2. ruby - 如何在 buildr 项目中使用 Ruby 代码? - 2

    如何在buildr项目中使用Ruby?我在很多不同的项目中使用过Ruby、JRuby、Java和Clojure。我目前正在使用我的标准Ruby开发一个模拟应用程序,我想尝试使用Clojure后端(我确实喜欢功能代码)以及JRubygui和测试套件。我还可以看到在未来的不同项目中使用Scala作为后端。我想我要为我的项目尝试一下buildr(http://buildr.apache.org/),但我注意到buildr似乎没有设置为在项目中使用JRuby代码本身!这看起来有点傻,因为该工具旨在统一通用的JVM语言并且是在ruby中构建的。除了将输出的jar包含在一个独特的、仅限ruby​​

  3. ruby - 使用 C 扩展开发 ruby​​gem 时,如何使用 Rspec 在本地进行测试? - 2

    我正在编写一个包含C扩展的gem。通常当我写一个gem时,我会遵循TDD的过程,我会写一个失败的规范,然后处理代码直到它通过,等等......在“ext/mygem/mygem.c”中我的C扩展和在gemspec的“扩展”中配置的有效extconf.rb,如何运行我的规范并仍然加载我的C扩展?当我更改C代码时,我需要采取哪些步骤来重新编译代码?这可能是个愚蠢的问题,但是从我的gem的开发源代码树中输入“bundleinstall”不会构建任何native扩展。当我手动运行rubyext/mygem/extconf.rb时,我确实得到了一个Makefile(在整个项目的根目录中),然后当

  4. ruby - Ruby 的 Hash 在比较键时使用哪种相等性测试? - 2

    我有一个围绕一些对象的包装类,我想将这些对象用作散列中的键。包装对象和解包装对象应映射到相同的键。一个简单的例子是这样的:classAattr_reader:xdefinitialize(inner)@inner=innerenddefx;@inner.x;enddef==(other)@inner.x==other.xendenda=A.new(o)#oisjustanyobjectthatallowso.xb=A.new(o)h={a=>5}ph[a]#5ph[b]#nil,shouldbe5ph[o]#nil,shouldbe5我试过==、===、eq?并散列所有无济于事。

  5. ruby - RSpec - 使用测试替身作为 block 参数 - 2

    我有一些Ruby代码,如下所示:Something.createdo|x|x.foo=barend我想编写一个测试,它使用double代替block参数x,这样我就可以调用:x_double.should_receive(:foo).with("whatever").这可能吗? 最佳答案 specify'something'dox=doublex.should_receive(:foo=).with("whatever")Something.should_receive(:create).and_yield(x)#callthere

  6. ruby-on-rails - 项目升级后 Pow 不会更改 ruby​​ 版本 - 2

    我在我的Rails项目中使用Pow和powifygem。现在我尝试升级我的ruby​​版本(从1.9.3到2.0.0,我使用RVM)当我切换ruby​​版本、安装所有gem依赖项时,我通过运行railss并访问localhost:3000确保该应用程序正常运行以前,我通过使用pow访问http://my_app.dev来浏览我的应用程序。升级后,由于错误Bundler::RubyVersionMismatch:YourRubyversionis1.9.3,butyourGemfilespecified2.0.0,此url不起作用我尝试过的:重新创建pow应用程序重启pow服务器更新战俘

  7. ruby - Sinatra:运行 rspec 测试时记录噪音 - 2

    Sinatra新手;我正在运行一些rspec测试,但在日志中收到了一堆不需要的噪音。如何消除日志中过多的噪音?我仔细检查了环境是否设置为:test,这意味着记录器级别应设置为WARN而不是DEBUG。spec_helper:require"./app"require"sinatra"require"rspec"require"rack/test"require"database_cleaner"require"factory_girl"set:environment,:testFactoryGirl.definition_file_paths=%w{./factories./test/

  8. ruby-on-rails - 新 Rails 项目 : 'bundle install' can't install rails in gemfile - 2

    我已经像这样安装了一个新的Rails项目:$railsnewsite它执行并到达:bundleinstall但是当它似乎尝试安装依赖项时我得到了这个错误Gem::Ext::BuildError:ERROR:Failedtobuildgemnativeextension./System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/bin/rubyextconf.rbcheckingforlibkern/OSAtomic.h...yescreatingMakefilemake"DESTDIR="cleanmake"DESTDIR="

  9. ruby-on-rails - 迷你测试错误 : "NameError: uninitialized constant" - 2

    我遵循MichaelHartl的“RubyonRails教程:学习Web开发”,并创建了检查用户名和电子邮件长度有效性的测试(名称最多50个字符,电子邮件最多255个字符)。test/helpers/application_helper_test.rb的内容是:require'test_helper'classApplicationHelperTest在运行bundleexecraketest时,所有测试都通过了,但我看到以下消息在最后被标记为错误:ERROR["test_full_title_helper",ApplicationHelperTest,1.820016791]test

  10. ruby - 如何根据特征实现 FactoryGirl 的条件行为 - 2

    我有一个用户工厂。我希望默认情况下确认用户。但是鉴于unconfirmed特征,我不希望它们被确认。虽然我有一个基于实现细节而不是抽象的工作实现,但我想知道如何正确地做到这一点。factory:userdoafter(:create)do|user,evaluator|#unwantedimplementationdetailshereunlessFactoryGirl.factories[:user].defined_traits.map(&:name).include?(:unconfirmed)user.confirm!endendtrait:unconfirmeddoenden

随机推荐