用途:convex-test 用于为应用中的 Convex 函数生成测试,帮助开发者在本地以自动化方式验证函数行为。
主要能力:该技能基于 convex-test 与 vitest,在内存后端中测试 Convex 函数。可覆盖的参数与返回值测试、鉴权路径(通过 withIdentity)、错误路径、索引以及定时函数(通过 t.finishInProgressScheduledFunctions)等。
使用方式:先安装 convex-test 与 vitest;再编写使用 convexTest(schema) 的测试,通过 t.run 播种数据,调用 t.query/t.mutation 并进行断言;同时覆盖鉴权、错误路径与定时函数;最后运行 vitest,并保持测试确定性。
适用场景:适用于需要在本地快速、可重复地验证 Convex 函数逻辑、鉴权与错误处理、索引行为和定时函数执行的开发流程。
限制与规则:必须使用内存版 convex-test,而不是实时部署;测试应覆盖鉴权与错误路径,而不仅仅是正常路径;测试需保持确定性,不使用真实时间或网络。