convex-test

get-convex/agent-skills/convex-test

This skill guides you in generating tests for your app's Convex functions using convex-test and vitest. It covers testing against an in-memory backend, including args/returns, auth paths, indexes, and scheduled functions. The workflow involves installing convex-test and vitest, writing tests with convexTest(schema), seeding via t.run, calling t.query/t.mutation, and asserting results. It also emphasizes covering auth (withIdentity), error paths, and scheduled functions (t.finishInProgressScheduledFunctions). Tests should be deterministic, avoiding real time or network dependencies.

설치 수 · 495출처 보기

Installation

npx skills add https://github.com/get-convex/agent-skills --skill convex-test

스킬 파일

SKILL.md

최근 동기화 · 2026. 8. 29.

SKILL.md›

---
name: convex-test
description: "Generate convex-test tests for the app's Convex functions."
---

<!-- GENERATED from convex-agents content/capabilities/test.json — do not edit by hand. -->

# Generate Convex tests

Use convex-test + vitest to test functions against an in-memory backend: args/returns, auth paths, indexes, and scheduled functions.

## Workflow

1. Install convex-test + vitest.
2. Write tests using convexTest(schema): seed via t.run, call t.query/t.mutation, assert.
3. Cover auth (withIdentity), error paths, and scheduled functions (t.finishInProgressScheduledFunctions).
4. Run vitest; keep tests deterministic.

## Rules

- Use convex-test (in-memory), not a live deployment.
- Cover auth + error paths, not just the happy path.
- Keep tests deterministic (no real time/network).