testing

用途

该技能用于编写和维护可靠的测试，基于 Vitest v4 的双配置方案，适用于 redpanda-data/console 项目。

触发条件

• 编写或修改测试
• 调试测试失败
• 设置 mock
• 有关测试配置的问题

主要能力

技能提供规则文档（rules/ 目录）指导以下场景：

• 选择测试类型：test-unit-vs-integration.md
• Mock 模块：test-mock-patterns.md
• 测试 store：test-zustand-stores.md
• Mock Connect API：mock-transport.md
• 跳过 UI 渲染测试：no-ui-rendering-tests.md

使用方式

命令：

• bun run test — 全部测试（CI 默认）
• bun run test:ci — CI 顺序执行
• bun run test:unit — 仅单元测试
• bun run test:integration — 仅集成测试
• bun run test:ui — 交互式 UI
• bun run test:watch — 监听模式
• bun run test:coverage — 覆盖率报告

关键要点

• .test.ts = 单元测试（Node.js），.test.tsx = 集成测试（JSDOM）
• React 组件测试始终使用 test-utils/test-utils.tsx
• 测试功能是否完整接线：UI 元素必须连接到实际功能

功能完整性测试

在实现交互功能（按钮、表单等）时：

• 验证事件处理器调用正确的函数并传入正确的参数
• 测试 AbortSignal、回调等其他“管道”是否被传递
• 不要假设 UI 存在就意味着功能可用——要测试连接

适用场景

• 编写 .test.ts 或 .test.tsx 文件
• Mock 模块、store 或传输
• 组件行为测试

限制

• 不适用于多页面用户工作流，这类场景应使用 e2e-tester

其他未在资料中明确说明的细节暂未提供。