接口测试教程 - Postman Newman 使用

现在只要谈到自动化测试,必然谈到持续集成(CI)。目前最流行的持续集成工具就是Jenkins,为了与Jenkins结合,那么这些自动化测试工具都必须要支持命令行执行方式,也就是说能够通过命令行来运行自动化测试的用例。

为此,Newman就是 Postman 提供的命令行执行工具,可以在命令行中执行 Collection 运行过程,并生成测试报告。这样就能把 Postman 编写的接口测试用例与持续集成工具和系统构建结合起来。

使用 Newman 执行 Collection ,必须把 Collection 导出为 Json 文件。以我们之前一直用的 Postman echo 为例:

image

导出的文件名为Postman Echo.postman_collection.json

使用 Newman 执行的效果为:

image

安装 Newman

Newman 是基于 Node.js 开发,因此必须要先安装 Node.js 环境。

下载 Node.js 并安装之后,可以在 CMD 中使用 npm 命令安装 Newman:

npm install -g newman

等待安装完成即可。

Newman 基本命令

上面我们已经演示了最基本的命令,也就是直接指定一个 Collection 导出的 Json 文件运行:

newman run collection.json

Newman 完整命令

如果你只想通过 Newman 运行 Collection,或者在 Jenkins 中执行接口用例。你可以参考如下这个完整的命令,仿写就可以了:

newman run postman_collection.json 
-e postman_environment.json 
-d test_data.csv 
-g postman_globals.json 
-n 迭代次数  
-r cli,html,json,junit 
--reporter-json-export jsonOut.json 
--reporter-junit-export xmlOut.xml 
--reporter-html-export htmlOut.html

简要说明:

  • postman_collection.json:导出的 collection 文件名
  • postman_environment.json:包含环境变量的环境文件
  • test_data.csv:数据文件,也可以是 Json 格式。具体格式参考运行参考设置
  • postman_globals.json:包含全局变量的文件
  • 迭代次数:重复执行所有请求的次数
  • cli,html,json,junit:指定导出报表格式,cli 指控制台的标准输出,html 为导出 html 报告,json 为 json 格式报告,Junit 导出 xml格式的报告;你需要导出哪些报表,就要先指定导出的格式
  • jsonOut.json/xmlOut.xml/htmlOut.html:分别指定报告文件存放的路径,如果不指定,会在命令所在的当前目录下生成一个 Newman 目录来存放。

如果你想更为深入的了解 Newman 所有参数,你可以查看本文的后续内容。


参数选项

除了上面的基本命令外,Newman 还提供了很多参数选项。

如果要查看所有参数,可以使用 -h 参数:

newman -h

可以看到 Newman 有如下选项:

Options:

公共设置选项:
-h, --help                       展示参数信息
-v, --version                    查看 Newman 版本

基本设置选项:
--folder [folderName]             指定要从集合运行的单个文件夹
-e, --environment [file|URL]      通过json文件指定环境(环境模块导出的)
-d, --iteration-data [file]       指定要使用json或csv的数据文件
-g, --globals [file]              通过文件指定全局变量(全局变量设置模块导出的)
-n, --iteration-count [number]    指定要迭代运行的次数
-r, --reporters [reporters]       指定用于此运行的报告类型(默认值:cli,也就是控制台输出)

请求设置选项:
--delay-request [number]        指定请求之间的延迟(毫秒)
--timeout [n]                   指定 collection 运行的超时时间(毫秒)(默认值:0)
--timeout-request [number]      为请求指定请求超时(毫秒)
--timeout-script [n]            指定脚本运行超时时间(毫秒)(默认为:0)

其他杂项:
--bail                         当有断言失败时停止所有运行
--silent                       禁止在命令行界面输出日志
--color                        强制进行彩色输出(在 CI 环境中使用)
--no-color                     禁止命令行界面输出日志中使用彩色
-k, --insecure                 禁用 SSL 
--ssl-client-cert        指定客户端 SSL 证书的路径。支持 .cert 和 .pfx 文件。
--ssl-client-key         指定客户端 SSL 密钥的路径
--ssl-client-passphrase  指定客户端 SSL 密码(可选,需要密码保护密钥)
-x, --suppress-exit-code       即使失败也继续运行测试,但退出时 code=0
--ignore-redirects             忽略重定向(响应状态码为3XX)
--export-environment     完成运行后,将环境导出到文件中
--export-globals         完成运行后,导出全局变量到文件中
--export-collection      指定输出文件保存执行的 collection
--disable-unicode              强制将符合 unicode 的符号替换为等效的纯文本
--global-var            允许通过命令行以 key = value 格式指定全局变量

参数解释

--folder [folderName] 运行单个文件夹

直接指定 Collection 的 Json 文件运行的时候默认是运行整个 Collection,可以通过 --folder 可以指定 Collection 中的某个文件夹来运行。

也就是部分运行了:

image

运行上图中导出的 Collection,并指定运行Request Methods文件夹:

image

命令如下:

newman run "Echo.postman_collection.json" --folder "Request Methods"

-e, --environment [file|URL] 指定环境文件

在 Postman 中运行时,可以通过界面指定运行的环境 Environment 。在 Newman 中就必须需要通过参数指定了。

之前讲环境的时候已经讲过,Postman 中的环境可以导出为 Json 文件。在 Newman 运行时,可以使用 -e 参数指定导出的环境 Json 文件。

例如:导出的环境文件名为localhost.postman_environment.json

newman run "Postman Echo.postman_collection.json" -e localhost.postman_environment.json

-d, --iteration-data [file] 指定要使用json或csv的数据文件

运行参考设置一节中我们讲过了 Postman 支持的数据文件类型(csv,json),并了解了文件的格式。

在 Newman 中运行时,通过 -d 参数指定这些数据文件。

newman run "Postman Echo.postman_collection.json" -d user.csv 

-g, --globals [file] 指定全局变量文件

-g 参数,通过文件指定当次运行 Collection 中所需要的全局变量。

全局变量文件可以从 Postman 中导出,也可以遵照全局变量的文件格式自己书写,再通过 -g 参数指定。

newman run "Postman Echo.postman_collection.json" -g globals.json

-n, --iteration-count [number] 指定要迭代运行的次数

通过 -n 次数,可以指定当次运行 Collection 的次数。对迭代不熟悉的同学,也可以参考运行参考设置中关于迭代的解释部分。

-r, --reporters [reporters] 指定用于此运行的报告类型

通过 -r 指定报告的类型,不指定的话默认就是 cli , 也就是控制台输出。
注意,指定多种报告类型的时候中间不能有空格,必须以逗号分隔:

✅ -r cli,json,junit
❌ -r cli , json,junit

如果指定了多个报告,并想为每个报告指定选项的话(比如指定某些报告的保存路径),则需要通过如下方式额外指定:

--reporter-{{reporter-name}}-{{reporter-option}}

{{reporter-name}}:指定报告名称,如 cli,json,junit,html 等
{{reporter-option}}:选项,如指定路径 export

比如 指定报告类型为 cli 和 Junit,而 Junit 导出的文件我想指定保存到 d:\data\report,就可以写为:

-r cli,junit --report-junit-export d:\data\report\junit_report.xml

1人点赞

接口自动化测试

"有钱的捧个钱场,没钱的点个赞呗!"

赞赏支持 还没有人赞赏,支持一下

猫与测试

不求完美,先开始,再完善它。 测试技术交流加群 655453482 加群获取 Pyt...

总资产79 (约7.16元)共写了15.1W字获得847个赞共618个粉丝

已关注

作者:猫与测试
链接:https://www.jianshu.com/p/e309d7f67997
来源:
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

你可能感兴趣的:(接口测试教程 - Postman Newman 使用)