关于 convex-test
使用 convex-test 和 vitest 为 Convex 函数生成测试的技能。测试在内存后端运行,覆盖参数与返回值、身份验证、错误路径、索引和定时任务,并强调确定性。
主要功能
- 01使用内存后端测试
- 02验证参数与返回值
- 03覆盖身份验证和错误路径
- 04测试索引与定时函数
- 05保持测试确定性
适用场景
- 01验证 Convex 查询和变更
- 02测试身份验证与错误处理
- 03检查定时函数行为
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ get-convex/ agent-skills --skill convex-test安装后在 Claude Code 中输入/convex-test确认已加载。
详细介绍
生成 Convex 测试
使用 convex-test + vitest 针对内存后端测试函数:包括参数/返回值、身份验证路径、索引和定时函数。
工作流
- 安装 convex-test + vitest。
- 使用 convexTest(schema) 编写测试:通过 t.run 填充数据,调用 t.query/t.mutation,并进行断言。
- 覆盖身份验证(使用 withIdentity)、错误路径和定时函数(t.finishInProgressScheduledFunctions)。
- 运行 vitest;保持测试结果确定。
规则
- 使用 convex-test(内存后端),不要连接实时部署。
- 覆盖身份验证和错误路径,而不只是正常路径。
- 保持测试结果确定(不使用真实时间/网络)。
评论
支持 Markdown