E2E Test Report

Date: YYYY-MM-DD HH:MM Duration: Xm Ys Status: PASSING / FAILING

Summary

• Total: X | Passed: Y (Z%) | Failed: A | Flaky: B | Skipped: C

Failed Tests

test-name

File: tests/e2e/feature.spec.ts:45 Error: Expected element to be visible Screenshot: artifacts/failed.png Recommended Fix: [description]

Artifacts

• HTML Report: playwright-report/index.html
• Screenshots: artifacts/*.png
• Videos: artifacts/videos/*.webm
• Traces: artifacts/*.zip

模板设计上，“Summary”一行汇总总量/通过/失败/Flaky/跳过五档状态，其中把 **Flaky 单列**为独立计数，正对应上文的隔离策略——被 `fixme/skip` 隔离的用例不应混入 Failed；每个失败用例条目固定包含文件定位、错误信息、截图路径与修复建议四要素，使报告可直接转化为 Issue 清单。产物路径一栏与上文配置（`playwright-report/`、`artifacts/`、`artifacts/videos/`）完全对齐。

## 场景化扩展：Web3 钱包与关键资金流

技能文档最后给出两个高价值场景的完整用例。

**钱包/Web3 测试**——用 `addInitScript` 注入 mock 钱包 provider，绕开真实 MetaMask 扩展，让钱包连接流程可离线、可重复地测试：

```typescript
test('wallet connection', async ({ page, context }) => {
  // Mock wallet provider
  await context.addInitScript(() => {
    window.ethereum = {
      isMetaMask: true,
      request: async ({ method }) => {
        if (method === 'eth_requestAccounts')
          return ['0x1234567890123456789012345678901234567890']
        if (method === 'eth_chainId') return '0x1'
      }
    }
  })

  await page.goto('/')
  await page.locator('[data-testid="connect-wallet"]').click()
  await expect(page.locator('[data-testid="wallet-address"]')).toContainText('0x1234')
})

技巧核心：addInitScript 在任何页面脚本之前执行，注入的 window.ethereum 会在 DApp 检测注入钱包时被命中，从而把“连接钱包”这一依赖浏览器扩展的流程变成纯 Playwright 可测的场景。

金融/关键流测试——涉及真实资金的用例必须带环境护栏，并精确等待上链接口确认：

test('trade execution', async ({ page }) => {
  // Skip on production — real money
  test.skip(process.env.NODE_ENV === 'production', 'Skip on production')

  await page.goto('/markets/test-market')
  await page.locator('[data-testid="position-yes"]').click()
  await page.locator('[data-testid="trade-amount"]').fill('1.0')

  // Verify preview
  const preview = page.locator('[data-testid="trade-preview"]')
  await expect(preview).toContainText('1.0')

  // Confirm and wait for blockchain
  await page.locator('[data-testid="confirm-trade"]').click()
  await page.waitForResponse(
    resp => resp.url().includes('/api/trade') && resp.status() === 200,
    { timeout: 30000 }
  )

  await expect(page.locator('[data-testid="trade-success"]')).toBeVisible()
})