hitspec supports 5 output formats for test results. Select the format with the --output flag (or -o).
console (default)
Human-readable colored terminal output with pass/fail indicators, response times, and a summary.
Supports verbosity levels:
-v — show request/response details-vv — show headers-vvv — show full bodies
Options:
--no-color — disable colored output--quiet — suppress all output except errors
json
Machine-readable JSON output containing test results, durations, and assertion details. Useful for integration with other tools.
Output structure:
JSON output is the format used by hitspec diff for comparing test runs.
junit
JUnit XML format compatible with CI/CD systems like GitHub Actions, GitLab CI, Jenkins, and CircleCI.
Most CI systems can parse JUnit XML natively for test result visualization.
GitHub Actions Example
Grant the workflow or job token checks: write when publishing check runs.
tap
Test Anything Protocol output, compatible with TAP consumers and harnesses.
Output:
html
Self-contained HTML report with styling, suitable for sharing or archiving.
The report includes:
- Summary dashboard with pass/fail counts
- Individual test results with durations
- Assertion details for failed tests
- Dark theme styling
Writing to Files
By default, all formats write to stdout. Use --output-file to write to a file instead:
Quick Reference
