convex-test

Use the convex-test library with vitest to run functions against an in-memory backend. Create a test instance with convexTest(schema), seed data via t.run, then call t.query or t.mutation and assert the results.

Call t.withIdentity to simulate an authenticated user before invoking the mutation. This lets you verify both authorized success paths and permission-denied error paths without configuring a real auth provider.

Yes, convex-test supports scheduled functions through t.finishInProgressScheduledFunctions, which completes pending scheduled work so you can assert its effects. Tests remain deterministic because no real timers or network calls are involved.

Cover authentication states, argument validation errors, and index or edge-case behavior in addition to successful returns. Testing only the happy path misses the failure modes most likely to break in production.

Flakiness usually comes from relying on real time, network calls, or a live deployment. convex-test runs entirely in memory, so keep tests free of real clocks and external services to stay deterministic.