junit-xray-cypress-reporter

This reporter offers the ability to specify a Jira-Issue for each it{} inside your cypress test and creates a custom report that is easy to load into XRAY. The reporter helps you to integrate your Cypress/Mocha test with XRay easily by producing enriched JUnit-style XML test report files which can be uploaded into XRay with API or other tools.

This reporter is built on the top of mocha-junit-reporter v2.2.1 so all the configurations in the official doc, are inherited from this npm package.

JUnit Xray Reporter is a custom reporter for use with:

• XRay Native Test Management for Jira
• Cypress testing frameworks

INSTALLATION

As a dev module:

1$ npm install junit-xray-cypress-reporter --save-dev

or as a global module:

1$ npm install -g junit-xray-cypress-reporter

CONFIGURATION

Test level

1describe('My First Test', () => {
2  it('Does not do much!', {jiraKey:"CALC-1234"}, () => {
3    or
4  it('Does not do much!', {jiraID:"CALC-1234"}, () => {
5    expect(true).to.equal(true);
6  })
7})

Cypress configuration file (cypress.config.js)

Every others {reporterOptions} explained here: mocha-junit-reporter v2.2.1 are availabile.

1const { defineConfig } = require("cypress");
2module.exports = defineConfig({
3  reporter: "junit-xray-cypress-reporter",
4  reporterOptions: {
5    mochaFile: "cypress/results/my-test-output-[hash].xml"
6  },
7  e2e: {
8    setupNodeEvents(on, config) {
9      // implement node event listeners here
10    },
11  },
12});
13

AN EXAMPLE

1. Install 'junit-xray-cypress-reporter' to the cypress project

1$ npm install junit-xray-cypress-reporter --save-dev

2. Configure 'junit-xray-cypress-reporter' as the reporter and do other configurations as necessary. Configurations can be done in the cypress.config.js or in the command line.
   Add this to cypress.config.js

1const { defineConfig } = require("cypress");
2module.exports = defineConfig({
3  reporter: "junit-xray-cypress-reporter",
4  reporterOptions: {
5    mochaFile: "cypress/results/my-test-output-[hash].xml"
6  },
7  e2e: {
8    setupNodeEvents(on, config) {
9      // implement node event listeners here
10    },
11  },
12});
13

'mochaFile' is the path to the report file. When there are several test files run it will generate a report file for each test file, so in order to generate unique file names and not overwrite the existing ones, the [hash] is added to the name of the report file.

3. Add cypress test with XRay-related elements

1describe('My First Test', () => {
2  it('Does not do much!', {jiraKey:"CALC-1234"}, () => {
3    expect(true).to.equal(true);
4  })
5})

4. Run tests and generate report

1npx cypress run --spec "path/to/file"

5. View report file

Report file generated at '<Cypress_project_root>/cypress/results'.

"my-test-output-828a1c4885dc687b1a19e11e24b9437e.xml"

1<?xml version="1.0" encoding="UTF-8"?>
2<testsuites name="Mocha Tests" time="0.1070" tests="1" failures="0">
3  <testsuite name="Root Suite" timestamp="2023-01-27T13:51:23" tests="0" file="cypress\e2e\test.cy.js" time="0.0000" failures="0">
4  </testsuite>
5  <testsuite name="My First Test" timestamp="2023-01-27T13:51:23" tests="1" time="0.0700" failures="0">
6    <testcase name="My First Test Does not do much!" time="0.0820" classname="Does not do much!">
7      <properties>
8        <property name="test_key" value="CALC-1234"/>
9      </properties>
10    </testcase>
11  </testsuite>
12</testsuites>

As you can see the property has beenn added and now could be readed correctly by XRay.

1<properties>
2  <property name="test_key" value="CALC-1234"/>
3</properties>

7. Now just upload the report to XRay and the card in Jira will be updated automatically

MIGRATION TO NEWEST VERSION:

Reporter outdated configuration!

You just update this repo to the newest version and u get this error? Dont worry, the solution is easy.

The old and deprecated configuration was:

1describe('My First Test', () => {
2  it('Does not do much!', {xray:{jiraID:"CALC-1234"}}, () => {
3    expect(true).to.equal(true);
4  })
5})

Now I made it more easyer and clean:

1describe('My First Test', () => {
2  it('Does not do much!', {jiraID:"CALC-1234"}, () => {
3    expect(true).to.equal(true);
4  })
5})

or

1describe('My First Test', () => {
2  it('Does not do much!', {jiraKey:"CALC-1234"}, () => {
3    expect(true).to.equal(true);
4  })
5})

How to make an easy update of all the outdated configuration? With regex!

In VS code you can search for this string (ATTENTION: spaces and type of quotation marks can change can be single ' or double "):

1xray:\{jiraID:"(.*?)"\}

and replace it with

1jiraKey:"$1"

THE JOB IS DONE!

Happy testing to everyone!

ALEC-JS