- 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.
- JUnit/xUnit XML Format
- NUnit v3+ XML Format
- xUnit.net v2+ XML Format
- MSTest TRX Format
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
- 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
- Support for test and suite nesting
- Displays before and after hooks
- Review test code inline
- All test reports are first converted to JUnit format using junit-converter.
- Set
junit
option totrue
to get JUnit conversion results. - If you only require JUnit conversion, you can use junit-converter.
- 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.
- Full conversion process is described in junit-converter
- Converts <properties>, <system-out> and <system-err> elements to Mochawesome test context.
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`));
npm i -g mochawesome-converter
mochawesome-converter --testFile mytests/nunit.xml --testType nunit --junit true
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 asdotnet 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 tofalse
to display tests as skipped.switchClassnameAndName
- Switches classname and name attributes of testcase if your test naming data is generated in reverse order.
testType |
File Type |
---|---|
JUnit | JUnit/xUnit XML |
NUnit | NUnit v3+ XML |
xUnit | xUnit.net v2+ XML |
TRX | MSTest TRX |