convex-test について
convex-testは、convex-testとvitestでConvex関数のテストを作成するスキルです。インメモリバックエンドを使い、デプロイ環境に接続せずに動作を検証します。
主な機能
- 01convex-testとvitestでテストを作成
- 02クエリとミューテーションを実行
- 03引数と戻り値を検証
- 04認証、エラー、スケジュール関数を網羅
- 05テストの決定性を維持
活用シーン
- 01デプロイせずにConvex関数をテスト
- 02認証とエラーパスの確認
- 03スケジュール関数の動作検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ 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 対応