Playwright

npm install @tracera/playwright

Нужен Node.js ≥ 22.19 (см. Адаптеры автотестов). @tracera/playwright на npm.

В playwright.config.ts:

import '@tracera/playwright/register';
import { defineConfig } from '@playwright/test';

export default defineConfig({
  reporter: [['@tracera/playwright/reporter']],
  use: {
    screenshot: 'only-on-failure',
    video: 'retain-on-failure',
    trace: 'retain-on-failure', // or "on-first-retry"
  },
});

import "@tracera/playwright/register" оборачивает test.step и хуки в каждом процессе Playwright, чтобы tracera.comment / tracera.error попадали в нужный шаг.

Включите screenshot / video / trace один раз в конфиге — артефакты Playwright автоматически попадают в результат Tracera (не больше 10 вложений у результата и у каждого шага). При повторах Playwright в отчёт уходит только финальная попытка. Если это повтор (retry > 0), во вкладке Env будет PLAYWRIGHT_RETRY — значение testInfo.retry (1 — второй запуск).

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

Привязка `testCaseId` и `autotestName`

test / expect импортируйте из @playwright/test, tracera / annotations — из @tracera/playwright.

Если не задать autotestName, адаптер берёт название теста Playwright.

При объявлении (предпочтительно):

import { test, expect } from '@playwright/test';
import { annotations } from '@tracera/playwright';

test('login', { annotation: annotations(42, 'e2e/login') }, async ({ page }) => {
  await page.goto('/login');
  await expect(page.getByRole('button', { name: 'Sign in' })).toBeVisible();
});

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

import { test, expect } from '@playwright/test';
import { tracera } from '@tracera/playwright';

test('login', async ({ page }) => {
  tracera.testCase(42, 'e2e/login');
  await page.goto('/login');
  await expect(page.getByRole('button', { name: 'Sign in' })).toBeVisible();
});

Шаги

Используйте Playwright test.step — шаг пишется в секцию Тест. Можно вызвать tracera.step вместо него — в отчёте будет то же самое (единый API с другими адаптерами). Шаги внутри test.beforeEach попадают в Предусловие; шаги внутри test.afterEach — в Постусловие.

import { test } from '@playwright/test';
import { annotations } from '@tracera/playwright';

test.beforeEach(async ({ page }) => {
  await test.step('open shop', async () => {
    await page.goto('/shop');
  });
});

test('checkout', { annotation: annotations(10, 'e2e/checkout') }, async ({ page }) => {
  await test.step('add to cart', async () => {
    await page.getByRole('button', { name: 'Add' }).click();
  });
});

test.afterEach(async ({ page }) => {
  await test.step('cleanup', async () => {
    await page.goto('/cart/clear');
  });
});

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

Внутри шага — поля этого шага. Вне шага — поля результата.

import { test } from '@playwright/test';
import { tracera, annotations } from '@tracera/playwright';

test('login', { annotation: annotations(42, 'e2e/login') }, async ({ page }, testInfo) => {
  tracera.comment('result-level note');
  tracera.error('result-level error text');

  await test.step('open login', async () => {
    await page.goto('/login');
    tracera.comment('landed on login');
  });

  await testInfo.attach('suite-log.txt', {
    body: 'finished login flow',
    contentType: 'text/plain',
  });
});

Для своих файлов используйте testInfo.attach. Скриншоты, запись браузера и trace Playwright прикрепляет сам — в Tracera изображения открываются в лайтбоксе, запись — во встроенном плеере, а trace — в Trace Viewer.

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

import { test, expect } from '@playwright/test';
import { annotations } from '@tracera/playwright';

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

for (const row of rows) {
  test(row.name, { annotation: annotations(row.id, row.name) }, async ({ page }) => {
    await test.step('open', async () => {
      await page.goto(row.path);
    });
    await expect(page.getByRole('button', { name: 'Sign in' })).toBeVisible();
  });
}

Вместо annotations можно вызвать tracera.testCase(row.id, row.name) в теле теста.

Свои фикстуры

Расширяйте стандартный Playwright test как обычно: