Repository files navigation

Xcode-like HTML report for Unit and UI Tests

• Supports parallel testing
• Supports attachments:
  • .png
  • .jpeg
  • .heic
  • .txt
  • .log
  • .mp4
  • .gif
• Navigate through the report with the keyboard's arrow keys
• Filter out successful, failed, skipped, or mixed-result tests
• Displays information about the target device
• Displays activity logs
• Junit report(-j flag)
• Json report(--json flag)
• Shrink bundle size by removing unattached files
• Automatically convert heic images to browser-friendly format
• Render as a single html file with inline attachments or as a bundle
• Downsize image attachments

Install viaHomebrew

Install latest stable version

brew install xctesthtmlreport

Install latest frommain branch

brew install xctesthtmlreport --HEAD

Install viaMint

Install latest stable version

mint install XCTestHTMLReport/XCTestHTMLReport

Install latest frommain branch

mint install XCTestHTMLReport/XCTestHTMLReport@main

Run your UI tests usingxcodebuild without forgetting to specify theresultBundlePath

$ xcodebuildtest -workspace XCTestHTMLReport.xcworkspace -scheme SampleApp -destination'platform=iOS Simulator,name=iPhone 14,OS=16.0' -resultBundlePath TestResults

Then use the previously downloaded xchtmlreport tool to create the HTML report. Additionally,-i flag is also available to inline all resources, this is convenient for exporting the html file standalone. HTML file will be much heavier but much more portable.

$ xchtmlreport TestResults.xcresultReport successfully created at ./index.html

$ xchtmlreport TestResults1 TestResults2Report successfully created at ./index.html

This will create only one HTML Report in the path you passed with the -r option

You can generate junit reports with the-j flag

$ xchtmlreport -j TestResults1Report successfully created at ./index.htmlJUnit report successfully created at report.junit

You can generate json reports with the--json flag

$ xchtmlreport -json TestResults1Report successfully created at ./index.htmlJSON report successfully created at ./report.json

https://github.com/TitouanVanBelle/fastlane-plugin-xchtmlreport

Please create an issue whenever you find an issue or think a feature could be a good addition to XCTestHTMLReport. Always make sure to follow theContributing Guidelines. Feel free to take a shot at these issues.

Thank you to the original author of this tool,TitouanVanBelle! 🥳🎉

XCTestHTMLReport isavailable under the MIT license.