This Cypress plugin provides seamless integration with Xray for test management in Jira. It automates the creation and updating of test executions based on the results of Cypress test runs, allowing you to track automated test executions directly within Xray.

• Automatically create new test executions in Xray if none are specified.
• Update existing test executions with results from Cypress tests.

Install the plugin via npm:

npm install cypress-xray-integration

To use this plugin, you need to configure it in your Cypress setup. Add the plugin to your cypress.config.js file and set the required environment variables.

Add the following line to your cypress.config.js:

const xrayPlugin = require('cypress-xray-integration');

Include the plugin in the setupNodeEvents function in your cypress.config.js:

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      xrayPlugin(on, config);
    },
    env: {
      xray: {
        serverUrl: "YOUR_XRAY_SERVER",
        testPlan: "YOUR_TEST_PLAN_ID",
        testExecution: "YOUR_TEST_EXECUTION_ID", // Optional, leave blank to create new execution
        token: "YOUR_XRAY_API_TOKEN"
      }
    }
  }
});

Replace YOUR_XRAY_SERVER, YOUR_TEST_PLAN_ID, YOUR_TEST_EXECUTION_ID and YOUR_XRAY_API_TOKEN

To ensure that test results are correctly linked to the appropriate Xray test cases, you must include the Xray test case ID within the title of each it block in your test specifications. Here's an example:

describe('Login Functionality', () => {
    it('XDEMO-123: should successfully log in with valid credentials', () => {
        // Test code here
    });

    it('XDEMO-124 should display an error for invalid credentials', () => {
        // Test code here
    });
});

Replace XDEMO-123 and XDEMO-124 with the actual Xray test case IDs that correspond to your test cases.

Once configured, the plugin will automatically sync your test results with Xray based on the execution of your Cypress tests. No additional steps are required during test runs.

You can explicitly configure the plugin parameters during the Cypress run command by passing environment variables. For example:

cypress run --env xray.testPlan=XDEMO-595,xray.testExecution=,xray.token=YOUR_XRAY_API_TOKEN

This method is particularly useful for configuring different environments or specific test runs without changing the main configuration file.

Contributions are welcome! If you find any issues or have suggestions for improvement, feel free to open an issue or submit a merge request.

This project is licensed under the MIT License - see the LICENSE.md file for details.