spark-store/.agents/workflows/testing.md

description

description
测试编写流程

工作流说明

此工作流指导如何为新功能或 Bug 修复编写测试。

步骤

1. 确定测试范围

分析需要测试的功能点：

• 单元测试：测试独立函数/组件
• 集成测试：测试模块间交互
• E2E 测试：测试完整用户流程

2. 编写单元测试（Vitest）

在 src/__tests__/unit/ 目录下创建测试文件：

import { describe, it, expect } from "vitest";
import { someFunction } from "@/modules/example";

describe("someFunction", () => {
  it("should return expected result", () => {
    const result = someFunction(input);
    expect(result).toBe(expected);
  });
});

3. 编写组件测试

import { describe, it, expect } from "vitest";
import { mount } from "@vue/test-utils";
import AppCard from "@/components/AppCard.vue";

describe("AppCard", () => {
  it("should render app name", () => {
    const wrapper = mount(AppCard, {
      props: {
        app: {
          name: "Test App",
          pkgname: "test-app",
        },
      },
    });
    expect(wrapper.text()).toContain("Test App");
  });
});

4. 编写 E2E 测试（Playwright）

在 e2e/ 目录下创建测试文件：

import { test, expect } from "@playwright/test";

test("install app from store", async ({ page }) => {
  await page.goto("http://localhost:3344");
  await page.click("text=Test App");
  await page.click('button:has-text("安装")');
  await expect(page.locator(".install-progress")).toBeVisible();
});

5. 运行测试

# 运行单元测试
npm run test

# 运行测试并监听
npm run test:watch

# 运行 E2E 测试
npm run test:e2e

# 生成覆盖率报告
npm run test:coverage

6. 确保测试通过

• 所有单元测试必须通过
• E2E 测试覆盖主要用户流程
• 测试覆盖率不低于 70%

7. 提交代码

测试通过后，提交代码并创建 PR。

注意事项

• ⚠️ 不要测试第三方库的功能
• ⚠️ 保持测试独立性和可重复性
• ⚠️ 使用有意义的测试名称
• ⚠️ Mock 外部依赖（APM 命令、API 调用）

相关文档

• TESTING.md - 测试框架和规范
• DEVELOPMENT.md - 开发文档