@ai-testing-tool/forge-playwright

Playwright reporter for AI Testing Tool (Jira Forge quality hub).

Install

npm install -D @ai-testing-tool/forge-playwright @ai-testing-tool/forge-commons @playwright/test

Peer: @playwright/test ≥1.40.

Configure

// playwright.config.js
const { defineConfig } = require('@playwright/test');

module.exports = defineConfig({
  testDir: './test',
  reporter: [
    ['list'],
    [
      '@ai-testing-tool/forge-playwright',
      {
        // Defaults to mode=off (no credentials required)
        // mode: 'ingest' | 'file' | 'off',
        // projectKey: 'DEMO',
      },
    ],
  ],
});

Modes

| Mode | Behavior | | ---- | -------- | | off (default) | No network / file write | | file | Writes the ingest payload (default ./ai-testing-tool-results.json) | | ingest | POSTs the payload with format: jest-json |

Env (same as CLI): AI_TESTING_TOOL_MODE, AI_TESTING_TOOL_PROJECT_KEY, AI_TESTING_TOOL_INGEST_URL, AI_TESTING_TOOL_INGEST_TOKEN, AI_TESTING_TOOL_LAUNCH_NAME.

Helpers

const { test } = require('@playwright/test');
const { qa } = require('@ai-testing-tool/forge-playwright');

test('AUTH-101 login', async ({ page }) => {
  qa.suite('Auth');
  qa.fields({ layer: 'e2e' });

  // Steps: native Playwright API only — no qa.step()
  await test.step('open login', async () => {
    await page.goto('/login');
  });
});

Prefer Jira issue keys in test titles. Native test.step() hierarchy lands on assertionResults[].meta.qa.steps.

qa.attach({ contentType }) is metadata-only for now (binary upload deferred).

Dual path

Path A — Playwright JSON + CLI:

npx playwright test --reporter=json --output=ai-testing-tool-playwright.json
# Convert / upload with CLI when using raw Playwright JSON, or prefer Path B file mode:
npx @ai-testing-tool/forge-api-client --project DEMO --report ai-testing-tool-results.json

Path B — @ai-testing-tool/forge-playwright reporter (mode=ingest or mode=file):

AI_TESTING_TOOL_MODE=ingest \
AI_TESTING_TOOL_PROJECT_KEY=DEMO \
AI_TESTING_TOOL_INGEST_URL=... \
AI_TESTING_TOOL_INGEST_TOKEN=... \
npx playwright test

mode=file writes an ingest payload (jest-json shape A) ready for Forge. Path A raw Playwright JSON is a separate dual-path option for teams that already emit Playwright's JSON reporter.