convex-test について
convex-test と vitest を使って Convex 関数のテストを作成するスキルです。インメモリバックエンドで引数や戻り値、認証、エラー、インデックス、スケジュール関数を確認し、テストの決定性を保ちます。
主な機能
- 01インメモリバックエンドでのテスト
- 02引数と戻り値の検証
- 03認証とエラーパスのカバー
- 04インデックスとスケジュール関数のテスト
- 05テストの決定性を維持
活用シーン
- 01Convex のクエリとミューテーションの検証
- 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 対応