Test report files to JUnit converter

Overview

• Convert test report files to JUnit format.

Supported report formats

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

Conversion process

• All test reports are first converted to JUnit format using XSLT.
• Any nested test suites are flattened.
• TRX files undergo additional processing to enhance JUnit output.

JUnit

• Flattens any nested test suites.

NUnit

• NUnit v3+ XML is supported.
• Converts <properties> elements to JUnit <properties>.
• Converts <output> elements to JUnit <system-out>.
• Converts skipped test-case <reason> elements to JUnit <skipped> with message.
• Converts test-case <failure> elements to JUnit <failure> with message and stack trace.

xUnit.net

• xUnit.net v2+ XML is supported.
• Converts <traits> elements to to JUnit <properties>.
• Converts skipped test <reason> elements to JUnit <skipped> with message.
• Converts test <failure> elements to JUnit <failure> with message and stack trace.
• Supports single <assembly> per file, if multiple assemblies are present, only the first will be converted.

MSTest TRX

dotnet test generates TRX style files unless different logger is used.`

• Converts Output/ErrorInfo/ErrorInfo to JUnit <failure> with message.
• Converts Output/ErrorInfo/Message to JUnit <failure> message.
• Converts Output/ErrorInfo/StackTrace to JUnit <failure> stack trace.
• Converts Output/StdErr to JUnit <system-err>.
• Converts Output/StdOut to JUnit <system-out>.
• Converts Inconclusive and NotExecuted tests to <skipped> with message.
• Tests are split into multiple <testsuite> elements by test classname.
• Tests are ordered by name.
• Test suit times are not 100% accurate - displayed as a sum() of all test times.

Usage

npm i --save-dev junit-converter

const converter = require('junit-converter');

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

// Convert test report to JUnit format and save to file
// Set minify:true to save minified XML
converter.toFile(options).then(() => console.log(`JUnit report created`));

// Convert test report to JUnit format and return as 'pretty' XML string
// Set minify:true to returm minified XML string
converter.toString(options).then((result) =>{/*do something with result*/});

// Convert test report to JUnit format and return as JSON object for processing
converter.toJson(options).then((result) =>{/*do something with result*/});

CLI usage

npm i -g junit-converter

Convert test report to JUnit format and save to file

junit-converter --testFile mytests/nunit.xml --testType nunit

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 when saving file | | reportFile | string | testFile.name-junit.xml | JUnit report file name | | splitByClassname | boolean | false | Split into multiple test suites by test classname | | minify | boolean | false | Minify XML result |

• 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. Only used when saving to file.
• reportFile - JUnit file name. Only used when saving to file.
• 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.
  Should only be set to true if test report file contains single test suite. TRX report files are always split by classname, so this option is ignored for TRX files.

Supported testType options.

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