8000 GitHub - agracio/mochawesome-converter: Convert XML/TRX test reports to HTML (Mochawesone) and JUnit
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

agracio/mochawesome-converter

Repository files navigation

Test report files to Mochawesome and JUnit converter

Actions Status Codacy Badge Git Issues Closed Issues

Overview

  • Convert your XML/TRX test report files to Mochawesome JSON/HTML for easy viewing and troubleshooting.
  • Convert test report files to JUnit format.
  • Convert JUnit to HTML using Mochawesome.

Supported report formats

  • JUnit/xUnit XML Format
  • NUnit v3+ XML Format
  • xUnit.net v2+ XML Format
  • MSTest TRX Format

What is Mochawesome

Mochawesome is a custom test reporter originally designed for Mocha Javascript testing framework. It features a clean modern interface allowing users to easily view and navigate test runs.
https://github.com/adamgruber/mochawesome

Mochawesome Report

List of supported features

  • Simple, clean, and modern design
  • Per suite charts (via ChartJS)
  • Stack trace for failed tests
  • Support for displaying context information
  • Filters to display only the tests you want
  • Responsive and mobile-friendly
  • Offline viewing

Features not supported by converter

  • Support for test and suite nesting
  • Displays before and after hooks
  • Review test code inline

Conversion process

  • All test reports are first converted to JUnit format using junit-converter.
  • Set junit option to true to get JUnit conversion results.
  • If you only require JUnit conversion, you can use junit-converter.

All test types

  • Converts <skipped> test messages to Mochawesome test context values.
  • Converts <properties>, <system-out> and <system-err> to Mochawesome context values.
  • Converts <failure> and <error> elements to Mochawesome error stack.
  • Tests suites without any tests are excluded from Mochawesome and JUnit.
  • Attachments are not supported.

Conversion process to JUnit

JUnit

  • Converts <properties>, <system-out> and <system-err> elements to Mochawesome test context.

Usage

npm i --save-dev mochawesome-converter
const convert = require('mochawesome-converter');

let options = {
    testFile: 'mytesfiles/nunit.xml',
    testType: 'nunit',
    junit: true
}

convert(options).then(() => console.log(`Mochawesome report created`));

CLI usage

npm i -g mochawesome-converter
mochawesome-converter --testFile mytests/nunit.xml --testType nunit --junit true

Options

Option Type Default Description
testFile (required) string Path to test file for conversion
testType (required) string Test report type
reportDir string ./report Converted report output path
reportFilename string testFile.name-mochawesome.json Mochawesome report name
junit boolean false Create JUnit report?
junitReportFilename string testFile.name-junit.xml JUnit report file name
html boolean false Create Mochawesome HTML?
htmlReportFilename string testFile.name-mochawesome.html Mochawesome HTML file name
splitByClassname boolean false Split into multiple test suites by test classname
skippedAsPending boolean true Show skipped tests as pending in Mochawesome
switchClassnameAndName boolean false Switch test case classname and name
  • testFile - relative or absolute path to input test file.
  • testType - type of test report, not case-sensitive.
  • reportDir - will be created if path does not exist.
  • splitByClassname - If true, splits test cases into multiple test suites by classname.
    This is useful for test runners that generate tests under a single test suite such as dotnet test when using JUnit loggers.
    TRX report files are always split by classname, so this option is ignored for TRX files.
  • skippedAsPending - Mocha always reports skipped tests as pending and this is default behaviour of converter. Set to false to display tests as skipped.
  • switchClassnameAndName - Switches classname and name attributes of testcase if your test naming data is generated in reverse order.

Supported testType options.

testType File Type
JUnit JUnit/xUnit XML
NUnit NUnit v3+ XML
xUnit xUnit.net v2+ XML
TRX MSTest TRX

About

Convert XML/TRX test reports to HTML (Mochawesone) and JUnit

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Contributors 3

  •  
  •  
  •  
0