dannydainton/htmlextra
dannydainton
Newman htmlextra报告器的Docker镜像，用于生成扩展的HTML测试报告，支持迭代运行分离、自定义模板及多种报告定制选项，提供默认仪表板模板和暗色主题切换功能。
5 次收藏下载次数: 0状态：社区镜像维护者：dannydainton仓库类型：镜像最近更新：4 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
newman-reporter-htmlextra Docker镜像文档
镜像概述和主要用途
newman-reporter-htmlextra是一个基于Newman的扩展HTML报告器Docker镜像。它解决了Newman默认报告中迭代运行聚合的问题，提供了分离的迭代展示，并包含额外的handlebars助手以支持自定义模板创建。该镜像默认提供仪表板风格的报告模板，包含暗色主题切换功能，同时支持多种可选配置参数，可灵活定制报告内容和展示方式。
核心功能和特性
- 迭代运行分离：将不同迭代的测试结果分开展示，避免默认聚合显示的混乱
- 增强模板支持：提供额外的handlebars助手，支持用户创建更个性化的自定义模板
- 默认仪表板模板：内置直观的仪表板风格报告模板，包含关键测试指标和详细结果
- 暗色主题切换：支持一键切换明暗主题，提升不同环境下的阅读体验
- 丰富的定制选项：通过CLI参数可控制报告导出路径、标题、敏感数据显示等多个方面
使用场景和适用范围
- API自动化测试报告生成
- 持续集成/持续部署(CI/CD)流程中的测试结果可视化
- 需要详细展示迭代测试结果的场景
- 希望自定义测试报告样式和内容的团队或个人
- 需要隐藏敏感数据（如认证信息、响应体）的测试报告场景
使用方法和配置说明
基本使用
以下命令将拉取镜像并运行Postman集合，完成后在当前目录生成报告文件：
consoledocker run -t -v $(pwd):/etc/newman dannydainton/htmlextra run collection.json -r htmlextra
使用环境文件
运行时指定环境文件：
consoledocker run -t -v $(pwd):/etc/newman dannydainton/htmlextra run collection.json -e environment.json -r htmlextra
使用URL加载集合和环境
通过Postman共享链接或API链接加载集合和环境：
consoledocker run -t -v $(pwd):/etc/newman dannydainton/htmlextra run <集合URL> -e <环境URL> -r htmlextra
CLI选项
| CLI选项 | 描述 | 示例 |
|---|---|---|
--reporter-htmlextra-export <path> | 指定报告输出路径，未指定时默认写入当前工作目录的newman/文件夹 | newman run collection.json -r htmlextra --reporter-htmlextra-export ./results/report.html |
--reporter-htmlextra-template <path> | 指定自定义模板路径，依赖--reporter htmlextra和--reporter-htmlextra-export参数，未指定时使用默认模板 | newman run collection.json -r htmlextra --reporter-htmlextra-template ./template.hbs |
--reporter-htmlextra-showOnlyFails | 仅显示测试失败的请求 | newman run collection.json -r htmlextra --reporter-htmlextra-showOnlyFails |
--reporter-htmlextra-testPaging | 为请求视图中的测试添加分页功能 | newman run collection.json -r htmlextra --reporter-htmlextra-testPaging |
--reporter-htmlextra-browserTitle | 修改浏览器标签页标题，默认值为"Newman Summary Report" | newman run collection.json -r htmlextra --reporter-htmlextra-browserTitle "我的Newman报告" |
--reporter-htmlextra-title | 设置报告中央主标题，默认值为"Newman Run Dashboard" | newman run collection.json -r htmlextra --reporter-htmlextra-title "我的Newman报告" |
--reporter-htmlextra-titleSize | 设置主标题大小，范围1-6（数值越大标题越小），默认值为2 | newman run collection.json -r htmlextra --reporter-htmlextra-titleSize 4 |
--reporter-htmlextra-logs | 在报告中显示集合中的控制台日志语句，默认不显示 | newman run collection.json -r htmlextra --reporter-htmlextra-logs |
--reporter-htmlextra-hideResponse | 排除指定请求的响应体 | newman run collection.json -r htmlextra --reporter-htmlextra-hideResponse "认证请求" |
--reporter-htmlextra-showEnvironmentData | 在报告中显示运行时使用的所有环境变量 | newman run collection.json -r htmlextra --reporter-htmlextra-showEnvironmentData |
--reporter-htmlextra-skipEnvironmentVars | 排除指定的环境变量 | newman run collection.json -r htmlextra --reporter-htmlextra-skipEnvironmentVars "API_KEY" |
--reporter-htmlextra-omitHeaders | 排除所有请求头信息 | newman run collection.json -r htmlextra --reporter-htmlextra-omitHeaders |
--reporter-htmlextra-skipHeaders | 排除指定的请求头 | newman run collection.json -r htmlextra --reporter-htmlextra-skipHeaders "Authorization" |
--reporter-htmlextra-skipSensitiveData | 排除所有请求/响应头和请求/响应体，仅显示基本请求信息和测试结果，默认不启用 | newman run collection.json -r htmlextra --reporter-htmlextra-skipSensitiveData |
--reporter-htmlextra-showMarkdownLinks | 渲染测试名称和pm.expect()语句中的Markdown链接 | newman run collection.json -r htmlextra --reporter-htmlextra-showMarkdownLinks |
--reporter-htmlextra-noSyntaxHighlighting | 禁用代码语法高亮，可能提升大型报告的打开性能 | newman run collection.json -r htmlextra --reporter-htmlextra-noSyntaxHighlighting |
--reporter-htmlextra-showFolderDescription | 在报告中显示所有文件夹描述 | newman run collection.json -r htmlextra --reporter-htmlextra-showFolderDescription |
--reporter-htmlextra-timezone | 设置报告时间戳的时区 | newman run collection.json -r htmlextra --reporter-htmlextra-timezone "Australia/Sydney" |
自定义模板
可通过--reporter-htmlextra-template <path>参数传入自定义模板，未指定时将使用默认的https://github.com/DannyDainton/newman-reporter-htmlextra/blob/master/lib/dashboard-template.hbs%E3%80%82
交互式报告示例
- 显示所有成功请求的标准报告
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 htmlextra 镜像标签
docker pull docker.xuanyuan.run/dannydainton/htmlextra:<标签>
DockerHub 原生拉取命令
docker pull dannydainton/htmlextra:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"