Tracera
Пробный период

Cypress

npm install @tracera/cypress

Проверено на Node.js 22.19–26.12 и Cypress 14–16.2 (см. Адаптеры автотестов). @tracera/cypress на npm.

В cypress.config.ts:

import { defineConfig } from 'cypress';
import { registerTraceraPlugin } from '@tracera/cypress';

export default defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      return registerTraceraPlugin(on, config);
    },
    supportFile: 'cypress/support/e2e.ts',
  },
});

В файле support:

import '@tracera/cypress/support';

Для компонентного тестирования вызовите registerTraceraPlugin из component.setupNodeEvents и подключите тот же файл support.

Переменные окружения, режим прогона и повторы: Адаптеры автотестов.

Ключ Env при повторе: CYPRESS_RETRY.

Привязка testCaseId и autotestName

Импортируйте tracera и annotations из @tracera/cypress/runtime или используйте в тестах cy.traceraTestCase (команда доступна после import '@tracera/cypress/support' в support-файле). Имена в annotations — литералы (без {param}).

В объявлении (предпочтительно — привязка сработает, даже если сразу вызвать this.skip()):

import { annotations } from '@tracera/cypress/runtime';

it('login', annotations(42, 'e2e/login'), () => {
  cy.visit('/login');
  cy.get('[data-testid=sign-in]').should('be.visible');
});

Внутри теста (необязательно, если кейс уже привязан через annotations):

import { tracera } from '@tracera/cypress/runtime';

it('login', () => {
  tracera.testCase(42, 'e2e/login');
  cy.visit('/login');
  cy.get('[data-testid=sign-in]').should('be.visible');
});

Или: cy.traceraTestCase(42, "e2e/login").

Пропуск

Штатный skip Cypress (this.skip()). По желанию задайте comment результата через tracera.comment перед вызовом skip.

import { tracera, annotations } from '@tracera/cypress/runtime';

it('login', annotations(42, 'e2e/login'), function () {
  if (!Cypress.env('READY')) {
    tracera.comment('env not ready');
    this.skip();
  }
  cy.visit('/login');
});

Шаги

Используйте tracera.step или cy.traceraStep: вызов tracera.step(title, fn) / cy.traceraStep(title, fn), декоратор @tracera.step("…") на методе класса или tracera.step("…")(fn). В заголовке декоратора {name} / {0} подставляются из аргументов метода; вместо строки можно передать функцию, которая вернёт заголовок. В вызове tracera.step(title, fn) плейсхолдеры {name} / {0} не подставляются — передайте уже готовую строку. Асинхронный код выполняется в очереди команд Cypress. После import "@tracera/cypress/support" стандартные beforeEach / afterEach обёрнуты — шаги внутри них попадают в Предусловие / Постусловие результата. Хуки уровня suite (before / after) не попадают в отчёт.

import { tracera } from '@tracera/cypress/runtime';

beforeEach(() => {
  tracera.step('open shop', () => {
    return cy.visit('/shop');
  });
});

it('checkout', () => {
  tracera.testCase(10, 'e2e/checkout');
  tracera.step('add to cart', () => {
    return cy.get('[data-testid=add]').click();
  });
});

afterEach(() => {
  tracera.step('cleanup', () => {
    // …
  });
});

Декоратор на методе:

import { tracera } from '@tracera/cypress/runtime';

class Cart {
  @tracera.step('add {item}')
  async addToCart(item: string) {
    // …
  }
}

Комментарии, ошибки и вложения

Комментарии, ошибки и вложения: Адаптеры автотестов. Скриншоты при падении добавляются к результату, когда плагин зарегистрирован.

import { tracera } from '@tracera/cypress/runtime';

it('login', () => {
  tracera.testCase(42, 'e2e/login');
  tracera.comment('result-level note');
  tracera.error('result-level error text');

  tracera.step('open login', () => {
    return cy.visit('/login').then(() => {
      tracera.comment('landed on login');
      tracera.attachment({
        fileName: 'suite-log.txt',
        mimeType: 'text/plain',
        data: 'finished login flow',
      });
    });
  });
});

Параметризованные тесты

import { annotations } from '@tracera/cypress/runtime';

const rows = [
  { id: 42, name: 'e2e/login-ok', path: '/login' },
  { id: 43, name: 'e2e/login-sso', path: '/login/sso' },
];

for (const row of rows) {
  it(row.name, annotations(row.id, row.name), () => {
    cy.visit(row.path);
  });
}

Или вызовите tracera.testCase(row.id, row.name) внутри теста вместо annotations.