Newman 生成报告

大家好，我是阿萨。昨天阿萨还被Postman的差性能折磨着。打算昨天完结后，就放弃Postman21天打卡。数了一下，少了一天的内容。今天就把API测试报告补齐。

另外，升级最新版的Postman性能已经有很大提升了。加载不出来API的问题也解决了。

上一篇讲解Newman的文章如何使用Newman 命令行的方式去运行API脚本？ 这篇文章里newman 支持的参数是无法设置report的。但是API 测试的report 又是每一个自动化必备的产物。所以为了完整的完成一个自动化测试过程，我们今天就学习下如何生成报告。

生成报告之前，我们需要先安装一个软件。这是全局安装这个插件的方式。

npm install -g newman-reporter-htmlextra

如果是Library的方式集成到NodeJS 里的话，就需要如下方式安装。

npm install -S newman-reporter-htmlextra

如何是想在Docker 中直接运行newman， node 和报告，请使用如下命令。

docker pull dannydainton/htmlextra

具体用法：

newman run collection.json -r htmlextra

如果是在命令行里使用newman, 详细用法有：

1. 指定将输出HTML文件写入磁盘的路径。如果不指定，文件将被写入当前工作目录中的newman/。

#语法：

--reporter-htmlextra-export

#例子：

newman run collection.json -r htmlextra --reporter-htmlextra-export ./results/report.html

2. 指定用于呈现HTML报告的自定义模板的路径。此选项取决于运行命令中存在——reporter htmlextra和——reporter-htmlextra-export。如果不指定该选项，则使用默认模板

#语法

--reporter-htmlextra-template

#例子：

newman run collection.json -r htmlextra --reporter-htmlextra-template ./template.hbs

3. 使用此可选标志告诉报告程序只显示测试失败的请求。（一定要用这个，否则几十M）的html 打开可不容易呀。）

#语法

--reporter-htmlextra-showOnlyFails 

#例子

newman run collection.json -r htmlextra --reporter-htmlextra-showOnlyFails

4.使用此可选标志可向请求视图中的测试添加分页。

#语法

--reporter-htmlextra-testPaging

#例子

newman run collection.json -r htmlextra --reporter-htmlextra-testPaging

5. 使用此可选标志可更改浏览器选项卡中的标题名称。默认名称为“Newman Summary Report”。

#语法

--reporter-htmlextra-browserTitle

#例子

newman run collection.json -r htmlextra --reporter-htmlextra-browserTitle "My Newman report"

有了报告，有了newman 命令行运行，就可以直接在CI 里配置脚本去日常运行API 脚本了。也可以脱离 对Postman GUI 工具的依赖。

写完一个工具的系列，其实只是一个开始，在日常工作中不断让工具为工作服务，才是关键。所谓知易行难，一定要多用工具，了解其设计的想法。可以思考下工具为什么这么设计，如果自己设计的话，会设计哪些功能方便用户使用。

每天使用的过程才是技能精进的开始，不是看多少文章或者视频就可以让技能精进的。加油吧。打工人。