https://github.com/elaichenkov/cypress-zephyr

Cypress reporter and plugin for Zephyr Scale
https://github.com/elaichenkov/cypress-zephyr

cypress e2e reporting testing zephyr

Last synced: over 1 year ago
JSON representation

Cypress reporter and plugin for Zephyr Scale

• Host: GitHub
• URL: https://github.com/elaichenkov/cypress-zephyr
• Owner: elaichenkov
• License: mit
• Created: 2023-11-09T12:42:33.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-07T23:03:10.000Z (over 1 year ago)
• Last Synced: 2024-10-11T04:46:41.760Z (over 1 year ago)
• Topics: cypress, e2e, reporting, testing, zephyr
• Language: TypeScript
• Homepage:
• Size: 1.6 MB
• Stars: 8
• Watchers: 1
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# cypress-zephyr

## Description

This is a Cypress plugin that allows you to link your Cypress tests to Zephyr test cases and upload Cypress test results to Zephyr.

## Installation

```shell

npm install -D cypress-zephyr

```

## Usage

You need to add the following to your `cypress.config.ts` file:

```ts

import zephyrPlugin from 'cypress-zephyr/dist/plugin';

export default defineConfig({

  reporter: 'cypress-zephyr',

  reporterOptions: {

    projectKey: 'HEX', // Jira and Zephyr project key

    authorizationToken: process.env.ZEPHYR_AUTHORIZATION_TOKEN,

  },

  e2e: {

    setupNodeEvents(on, config) {

      zephyrPlugin(on, config);

    },

  },

});

```

Do not forget to add `ZEPHYR_AUTHORIZATION_TOKEN` to your environment variables. The token can be generated in Zephyr settings. Read more about it [here](https://support.smartbear.com/zephyr-scale-cloud/docs/rest-api/generating-api-access-tokens.html).

## Test case linking

To link your Cypress test to a Zephyr test case you need to add a `[R432]` tag to your test case title. The tag should contain a test case key.

For example, your test case id in Zephyr is `HEX-R432` then you need to add `[R432]` to your test case title. For instance:

```ts

describe('Main page', () => {

  it('[R432] should do something', () => {

    // ...

  });

});

```

After that you can run your tests as usual and see the results in Zephyr by clicking the link from terminal. The link will be printed after the tests are finished. Something like this:

```shell

📋 Zephyr Scale Report details:

┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐

│ ✅ Test cycle HEX-R9374 has been created                                                                                                                                        │

│ 👇 Check out the test result                                                                                                                                                    │

│ 🔗 https://company-x.atlassian.net/projects/HEX?selectedItem=com.atlassian.plugins.atlassian-connect-plugin%3Acom.kanoah.test-manager__main-project-page#!/testPlayer/HEX-R9374 │

└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

```

Please take a look at the [examples](./examples/) for different set up.

## Author

Yevhen Laichenkov 

## License

[MIT](./LICENSE)