Newman prints results to the terminal by default. That is the CLI reporter. But your manager does not read terminals. Your Jenkins dashboard does not parse terminal text. You need proper reports — HTML for humans, JUnit XML for CI tools, JSON for custom processing.
| Reporter | Output | Best For |
|---|---|---|
| cli | Terminal text with colors | Local development, quick checks |
| json | JSON file with all details | Custom processing, dashboards |
| junit | JUnit XML | Jenkins, GitLab CI, Azure DevOps |
# Default — cli reporter (always on unless you say otherwise)
newman run collection.json
# JSON reporter — export results to a file
newman run collection.json \
-r json \
--reporter-json-export reports/results.json
# JUnit reporter — for CI tools
newman run collection.json \
-r junit \
--reporter-junit-export reports/junit-results.xmlThe built-in reporters are basic. For a beautiful, detailed HTML report that your team will actually enjoy reading, install newman-reporter-htmlextra. It is the most popular Newman reporter in the community. Charts, request details, response bodies, failed test highlights — all in one page.
# Install the HTML reporter
npm install -g newman-reporter-htmlextra
# Run with HTML report
newman run collection.json \
-e environments/staging.json \
-r htmlextra \
--reporter-htmlextra-export reports/api-test-report.html
# Open the report in your browser
open reports/api-test-report.html # macOS
xdg-open reports/api-test-report.html # LinuxThe htmlextra report includes request/response details, console logs from your scripts, and a summary dashboard. Share the HTML file with your manager or attach it to a Slack message. It makes your testing effort visible.
You want terminal output while developing AND an HTML report for the team AND a JUnit report for Jenkins? Use all three at once. Separate reporter names with commas.
# Multiple reporters — CLI + HTML + JUnit
newman run collection.json \
-e environments/staging.json \
-r cli,htmlextra,junit \
--reporter-htmlextra-export reports/api-report.html \
--reporter-junit-export reports/junit-report.xml# Custom title and dark theme
newman run collection.json \
-r htmlextra \
--reporter-htmlextra-export reports/report.html \
--reporter-htmlextra-title "Staging API Test Report" \
--reporter-htmlextra-darkTheme \
--reporter-htmlextra-showOnlyFails \
--reporter-htmlextra-noSyntaxHighlightingCI tools like Jenkins, GitLab CI, and Azure DevOps can parse JUnit XML. They show test results in their dashboards, track pass/fail trends over time, and send notifications on failures.
<!-- What the JUnit XML looks like -->
<?xml version="1.0" encoding="UTF-8"?>
<testsuites name="My API Tests" tests="5" failures="1" time="2.345">
<testsuite name="Get All Users" tests="3" failures="0">
<testcase name="Status code is 200" time="0.342"/>
<testcase name="Response is an array" time="0.001"/>
<testcase name="Array has 10 users" time="0.001"/>
</testsuite>
<testsuite name="Get Single User" tests="2" failures="1">
<testcase name="Status code is 200" time="0.187"/>
<testcase name="Email matches expected" time="0.001">
<failure>AssertionError: expected 'Sincere@april.biz' to equal 'wrong@email.com'</failure>
</testcase>
</testsuite>
</testsuites>If you see "reporter not found" errors, it means the reporter package is not installed. For htmlextra: npm install -g newman-reporter-htmlextra. For local installs, make sure the reporter is in the same node_modules as Newman.
Q: What Newman reporters have you used? Which one is best for CI/CD?
A: I have used CLI for local development, htmlextra for stakeholder-friendly HTML reports, and JUnit for CI/CD integration. For CI/CD, JUnit is the best because tools like Jenkins and GitLab CI natively parse JUnit XML — they show test results in their dashboards and track trends over time. For human consumption, htmlextra is the best — it generates beautiful, interactive HTML with request/response details, charts, and failure highlights. You can use multiple reporters at once: -r cli,htmlextra,junit.
Key Point: CLI for your terminal, htmlextra for pretty HTML reports, JUnit for CI/CD dashboards. Use multiple reporters at once with -r cli,htmlextra,junit.