/test-execution

name: qa/test-execution
description: 测试执行方法，包含测试框架检测、测试运行、结果解析
version: 1.0.0
agent: qa
type: methodology
user-invocable: false
agent-invocable: true
dependencies:
  - shared/tech-stack-detection
triggers:
  - 需要执行测试时
  - 需要验证测试覆盖率时

测试执行方法

强制要求：真实执行测试

**你必须真正执行测试，禁止生成 Mock 数据！**

测试执行流程

1. **检测项目类型和测试框架** 2. **根据项目类型执行测试** 3. **执行 E2E / 集成测试** 4. **解析测试输出**（总数、通过数、失败数、覆盖率）

测试框架检测

JavaScript/TypeScript

• Jest: `jest.config.js`, `"jest"` in package.json
• Vitest: `vitest.config.js`, `"vitest"` in package.json
• Playwright: `playwright.config.js`
• Cypress: `cypress.json`

Python

• pytest: `pytest.ini`, `"pytest"` in dependencies
• unittest: 内置

Go

• `*_test.go` 文件

测试命令

| 语言 | 单元测试 | E2E测试 | |------|----------|---------| | Node.js | `npm test` | `npx playwright test` | | Python | `pytest` | `pytest tests/e2e` | | Go | `go test ./...` | - |

Playwright E2E 执行细节

> **完整方法论**：详见 `Skill(skill: "qa/e2e-playwright")`

检测 Playwright 项目

检查以下标志确认项目使用 Playwright：

• `playwright.config.ts` 或 `playwright.config.js` 存在
• `package.json` 中包含 `@playwright/test` 依赖
• `e2e/` 或 `tests/e2e/` 目录存在

执行命令

# 安装浏览器（首次或 CI 环境）
npx playwright install --with-deps

# 运行全部 E2E 测试
npx playwright test

# 仅 critical 标签（门禁加速）
npx playwright test --grep @critical

# 指定浏览器
npx playwright test --project=chromium

# JSON 报告（门禁解析用）
npx playwright test --reporter=json

结果解析

Playwright JSON 报告关键字段：

| 字段 | 说明 | |------|------| | `stats.expected` | 通过的测试数 | | `stats.unexpected` | 失败的测试数 | | `stats.flaky` | 重试后通过的测试数 | | `stats.skipped` | 跳过的测试数 |

失败排查

# 查看 trace（失败时自动生成）
npx playwright show-trace <trace.zip路径>

# 打开 HTML 报告
npx playwright show-report