Cypress-tags

This plugin helps to parse tags to add them into Mocha Test object, so you can access tags within hooks and within a test.

Example:

1    it('test with tags @test', { tags: ['@abc'] }, function () {
2      // this.test?.tags object has all tags
3      expect(this.test?.tags).to.deep.eq([
4        { tag: '@abc', info: [] },
5        { tag: '@test', info: [] },
6      ]);
7    });

Installation / setup

1. install with npm:

   1npm i -D @mmisty/cypress-tags

   or with yarn:

   1yarn add @mmisty/cypress-tags -D

2. configure project:

   Put into your support.ts (or e2e.ts) file

   1import '@mmisty/cypress-tags'

3. That's it! Types should be added automatically if you use typescript.

Adding tags

There are several ways to add tags:

1. inline tags - just add them into test or suite title (ex @simple, @tag("info"))

1it('test with tags @simple @tag("withInfo")', function () { 
2   // ...
3});

2. cypress configuration object:

1it('test with tags', { tags: ['@abc'] }, function () { 
2   // ...
3});

3. cypress configuration object may also have a string type and also parsed tag type:

1it('test with tags', { tags: '@abc' }, function () {
2   // ...
3});

1it('test with tags', { tags: [{ tag: '@abc', info: ['my info'] }] }, function () {
2   // ...
3});

Using tags

When tags are added to a test you can use them within hooks. This may be helpful when you want to do some action depending on tags:

Example (will skip tests with @skip tag):

1// my.test.ts
2it('test to skip @skip', function () {
3   // ...
4});
5
6// e2e.ts / setup.ts
7beforeEach(function() {
8  const test = this.currentTest;
9  if(test){
10    if(test.tags?.map(t => t.tag).includes('@skip')){
11      this.skip();
12    }
13  }
14})
15

Env

To see tags in test / suite title set env variable cyTagsShowTagsInTitle to true

If you want to keep titles as they are set variable to undefined

• todo: when var is true show only own tags