メインコンテンツへスキップ
見出し画像

うちのテスト、全部走らせてない?Vitest 5.1、まず `--since-last-run` だけ試そう

    今夜のひとこと

    土曜の夜、コーヒーをもう1杯。週末の前に、来週の自分へ「待ち時間の短縮」を1つだけ渡しておきたい。テストを全部走らせるのをやめて、変わったところだけ走らせる話です。

    Vitestでテストを書いている人、1つだけ変更したのに全テストを走らせてコーヒーを淹れ直している人が対象です。まずやることは1つだけ。`vitest run --since-last-run` を1回打つこと。それだけです。

    要点まとめ

    • Vitest 5.1が2026年11月2日に出た(公式ブログ)。目玉は「変わったテストだけ走らせる」`--since-last-run`。

    • `--last-failed` も新しく、直前の実行で落ちたテストだけをもう一度走らせられる。

    • ウォッチモードでスナップショットを1件ずつ確認できる対話レビューと、失敗時だけ記録するTrace Viewも入った。

    変わったテストだけ走る `--since-last-run`

    今までの `--changed` はGitと比べていた。だからコミットした瞬間に「変わった」が消えてしまうし、Gitがない場所では使えなかった。新しい `--since-last-run` は、前回の実行と比べる。

    vitest run --since-last-run

    最初の1回は全テストが走り、各テストが読み込んだファイル(動的importやモック、セットアップファイル、スナップショットまで)を記録する。2回目からは、そのファイルの更新時刻を見て、変わったファイルに関わるテストだけを走らせる。前回落ちたテストは、通るまで毎回走り直す。Gitを使わないので、新しいコンテナでも一時的な作業ツリーでも、リポジトリでない場所でも同じように動く。

    公式ブログが面白い使い方を挙げている。AIコーディングツールが編集のたびにテストを走らせる場合だ。エージェントは「変更したところだけ確かめたい」ので、このフラグがちょうどいい。ブログは `AGENTS.md` に「変更後は `vitest run --since-last-run`、仕上げに全体を1回 `vitest run`」と書く例まで載せている。僕もClaude Codeにテストを走らせることがあるので、これは来週の自分のために入れておきたい。

    落ちたテストだけ、もう一度 `--last-failed`

    ウォッチモードでは `f` キーで落ちたテストを走り直せたけれど、別プロセスではできなかった。5.1の `--last-failed` は、前回の実行結果のキャッシュを読んで、落ちたテストだけを走らせる。

    vitest run --last-failed
    vitest run --last-failed -t login

    `-t` と組み合わせて名前で絞ることもできる。テスト名の全体で選ぶので、他のテストを足したり動かしたりしても選び直しがズレない。`beforeAll` の中やテストの集計中に落ちた場合は、ファイル全体が走る。

    スナップショットは「まとめて更新」から「1件ずつ確認」へ

    スナップショットが落ちたとき、ウォッチモードの `u` キーは全部まとめて更新してしまう。5.1では `i` キーを押すと、落ちたスナップショットを1件ずつ表示して確認できる。

    Reviewing [1/3]:
    Source: src/user-card.test.ts:7:25 (renders the full name)

    `a` で新しいスナップショットを受け入れ、`r` で古いものを残す。最後まで見たら、受け入れた分だけ書き込んで、そのテストファイルを走り直す。インラインのスナップショット、`.snap` ファイル、ファイルスナップショットに加えて、ブラウザモードのARIAスナップショットにも対応している。僕は「まとめて更新」で意図しない変更まで通してしまったことがあるので、この1件ずつの確認は地味にありがたい。

    失敗したときの記録も、黙って付いてくる

    Vitest 5.0で実験的だったTrace Viewが、5.1で安定版になり、既定で `'failure-only'` になった。失敗したテストだけ記録が残り、通ったテストは記録のコストがほぼかからない。ブラウザモードのテストが落ちると、エラーレポートの末尾に「どの操作のあとで失敗したか」の手順が付く。カバレッジのIstanbulプロバイダも5〜10倍速くなった(Vitest自身の479ファイルで3.7秒→0.38秒)。カバレッジが遅くて敬遠していた人には、試すきっかけになるかもしれない。

    車の世界で言うと…

    車の世界で言うと、これは「全数検査から抜き取り検査への切り替え」に近い。全部の部品を毎回同じだけ調べるのではなく、変わったところと、前に不具合が出たところを重点的に見る。手抜きではなく、変わっていないところは変わっていないと分かっているからこその絞り込みだ。テストも同じで、「全部走らせる安心」と「変わったところだけ走らせる速さ」は、使い分けるものだと思う。

    実務ではこう効く

    今夜やることは、3つだけです。

    1. `npm install -D vitest@latest` で5.1に上げる(マイナー版なので、上げるハードルは低めだと思う)

    2. `vitest run --since-last-run` を1回打って、2回目から走るテストが減るのを確かめる

    3. 直近で落ちたテストがあれば `vitest run --last-failed` で、ウォッチモードなら `i` キーでスナップショットを1件ずつ確認する

    1つ注意点がある。`--since-last-run` は「前回の実行」との比較なので、仕上げには全体を1回 `vitest run` で走らせること。絞り込みは日々の作業用で、最終確認は全体で、という使い分けだ。

    僕もまだ自分のプロジェクトで試していないので、今夜まず2番までやってみる。テストの待ち時間が短くなれば、来週の小さな修正がもっと気軽になるはずだ。

    相棒キャラNibbleの一言

    「全部走らせるのは安心だけど、待ち時間もコストだよ。変わったところだけ、まず1回。」

    情報源

    ※2026年11月7日時点の情報です。Vitestの仕様は今後変わる可能性があります。

    #Vitest #テスト #TypeScript #Web開発 #フロントエンド #AI活用

     
     

    skcode

     
     
    自動車業界で12年エンジニアをして、2025年からWeb開発(React / Next.js)に転身しました。毎朝5時半に起きて走るのが日課。その朝の時間に、テックニュースから大事な1件だけを選んで書いています。AI・Web開発・セキュリティが中心です。

    あなたへのおすすめ