
Vitestのテスト時間、どう比べる? 計測と確認を試せる無料サンプル
プログラムを修正したあと、「きちんと動くか」を自動で確認するのがテストです。確認に時間がかかると、結果を待つ時間も長くなります。
その待ち時間を短くしたい。でも、必要な確認まで減らしてしまうのは困る。
そこで私が目指しているのは、必要なテストを残したまま改善を試し、その変更を採用してよいか判断できるようにすることです。
何を見直すかを選び、変更前後の時間を測り、必要な確認が残っているかを確かめる。その判断を助けるサンプルや手順、結果の読み方を、ほかの開発者も繰り返し使える形に整えていきたいと考えています。
その第一歩として、今回は「import」、つまり部品の読み込み先の見直しを試しました。
公開した無料サンプルが「Vitest CI Practice」です。プログラミング言語のTypeScriptと、テストを実行するツールのVitestを使っている方に向けています。この記事では、最初の試みで何が分かったかと、ここから確かめていきたいことを紹介します。
最初の題材は「部品の読み込み先」の見直し
プログラムは、別のファイルにある機能を読み込んで使えます。その指定を「import」と呼びます。
今回は、改善を試す最初の題材として、その読み込み先を見直しました。
変更前: 複数の機能をまとめたファイルを経由して読み込む。
変更後: 必要な機能が入っているファイルから直接読み込む。
このサンプルは、まとめたファイルを経由すると、使わない機能の準備処理も動く構成です。その準備を減らしたときに、テストの時間が変わるかを調べました。

テストの確認内容は保ち、読み込み先だけを変更しています。まずは変更を一つに絞り、「何を変えたか」「時間がどう変わったか」「必要な確認が残っているか」を一通り確かめられる例にしました。
試した結果、2.226秒から1.517秒になった
練習用の小さなプログラムで、部品の読み込み先だけを変更して比べました。
2026年9月21日、GitHubのクラウド上でプログラムを実行する機能「GitHub Actions」を使い、変更前と変更後を交互に、それぞれ3回測定しました。
測定変更前変更後1回目2.226秒1.525秒2回目2.176秒1.517秒3回目2.228秒1.497秒中央値2.226秒1.517秒
中央値は、3回の値を小さい順に並べたときの真ん中の値です。平均値とは異なります。
この測定では、中央値が0.709秒、約31.9%短くなりました。
同じ32件のテストは、変更前後の計6回すべてで成功しています。テストに含まれる、保存済みの期待結果と照らし合わせる16件の確認も成功しました。確認する内容や合格条件を減らして時間を短くしたわけではありません。
この小さな例で短くなった時間は、約0.7秒です。表はテスト実行を測った時間で、準備を含む作業全体の時間ではありません。そのまま大きな開発案件の削減時間や費用へ換算はできません。
なお、これは当時の版で得られた結果です。その後の修正を含む現在の配布版を、今回新たに測り直した結果ではありません。
別の測定では、短くならなかった
一方、別のタイミングで手元の環境から測定した記録には、5.193秒から5.281秒へ、約0.09秒長くなった組もありました。
先ほどのクラウド上の測定とは別の条件・別の実行です。両方の数値を混ぜて平均を出したり、一つの改善結果としてまとめたりはしていません。
この結果からも、読み込み先を変えれば必ず速くなるとは言えません。実行する環境や、そのときの負荷などによって時間は変わります。
だからこそ、自分の条件で測り、速くなったかと、必要な確認が残っているかを両方確かめることが大切です。短くならなかった結果も、その変更を採用するか決める材料になります。
この先は、試してもらった結果をもとに広げたい
今は、公開したサンプルと説明をほかの方が読んで、実行し、結果を理解できるかを確かめる段階です。importの見直しは、この比較・判断の進め方を具体的に試すための最初の題材と位置付けています。
今後は、次の順序で確かめながら進めたいと考えています。
段階確かめたいこと・目指す姿まず、公開サンプルを試してもらう説明だけで実行できるか。結果の読み方で迷わないか。次に、自分の開発で方法を使えるか確かめる許可されたプロジェクトで、時間の比較と必要なテストの確認に役立つか。共通する困りごとが見えたら、題材を検討する複数の利用者に共通する課題があれば、import以外の改善例や説明を追加するか考える。将来、繰り返し使える形に整える改善候補の選び方・比べ方・採用するための判断材料を、別の利用者にも提供できる形にしたい。
たとえば、テスト前の準備を重複して行っていないか、起動時に重い処理がないか、同時に動かすテストの数は適切か、といった点も題材の候補になります。これらは候補であり、追加する内容や時期が決まっているわけではありません。
目指すのは、「時間がかかるところを測る → 改善を一つ試す → 必要な確認を保てたか確かめる → 採用するか決める」という進め方を、繰り返し使えるようにすることです。どんなプロジェクトでも自動で原因を探して修正するツールにすることや、有料版の制作は、まだ決めていません。
無料サンプルで試せること
この記事で紹介する無料サンプル(v0.1.0)は、次のページから入手できます。「Assets」の「Source code (zip)」をダウンロードして展開してください。
無料サンプルを入手する:Vitest CI Practice v0.1.0
手順に沿って、次の流れを試せます。
変更前を確認する。 テストの内容が、あらかじめ決めた基準と一致しているか確認します。
一つだけ変えて測る。 専用プログラムが読み込み先を切り替え、同じ設定で変更前後を複数回測ります。
結果を読む。 途中で失敗していないか、必要なテストが実行されたかを確かめてから、時間を比べます。
確認内容が残ったかを見る。 テスト内容の維持と、書き換えたファイルが元へ戻ったことを確認します。
時間の比較とは別に、わざと入れた決まった不具合を、テストが見つけられるか試す手順もあります。
「最後まで動いた」「速くなった」「必要な確認を続けられた」は、それぞれ確認することが違います。この違いを、実際の出力を見ながら確かめられます。
自分の仕事に取り入れるときの注意点
この一式は、同梱の練習用プログラム専用です。自分のコードを入れるだけで、遅い原因を自動で探したり、直したりする道具ではありません。
自分の開発へ取り入れる際は、「何を一つ変えるか」「どのテストや設定を保つか」を、そのプロジェクトに合わせて決める必要があります。
たとえば、複数の機能をまとめたファイルが、ほかの人に使ってもらうための正式な入口なら、その入口から正しく使えるかを確認するテストも残します。直接読み込む方法へ、すべて置き換えればよいとは限りません。
この例では、データベースや外部サービスとの通信、ブラウザーの操作は扱っていません。あらゆる不具合を見つけられることや、どの環境でも時間・費用が減ることを保証するものでもありません。
試すために必要な環境
このサンプルを試すには、Node.jsとnpmが必要です。Node.jsはプログラムの実行環境、npmは必要なソフトを導入・管理する道具です。
対応するNode.jsは、22系の22.12.0以降、24系、または26.0.0以降です。Vitestなどの必要なソフトは、サンプルを展開したフォルダで npm ci を実行して導入します。
LinuxとWindowsで計測できます。Windowsでは開始から終了までの経過時間を比較し、CPU時間は取得しません。macOSでの実機確認は、まだ行っていません。
実行時には、OSやNode.js・npmのバージョンが結果に記録されます。基準環境との差が警告として表示される場合がありますが、警告だけで失敗したとは限りません。対応していないNode.jsや、必要なソフトがない場合などは実行を止めます。
変更前後は同じ環境で比較してください。別のOSや別の実行で得た時間は、それぞれ別の結果として扱います。
計測中はサンプルのimportを一時的に切り替えるため、ほかの編集を加えていない作業用コピーで試してください。npm run measure は1回だけ実行します。内部で変更前・変更後を交互に計6回計測し、終了時に元のファイルへ戻します。
準備から実行までの詳しい手順は、日本語の解説記事(Qiita)にまとめています。結果の見方や必要な環境は、v0.1.0の英語READMEでも確認できます。
動かなかった報告も受け付けています
試した感想や質問は、報告・質問窓口(GitHub Issues)へお願いします。Issuesは、質問や問題を文章で投稿できるページです。
次の二つを分けて、分かる範囲で教えてください。
公開サンプルを試した: どこまで進めたか。どの説明や結果で迷ったか。
自分の開発に比較方法を取り入れた: 許可された範囲で何を試し、役立った点や足りなかった点は何か。
実行できなかった場合や、準備で止まった場合も歓迎します。使ったサンプルの版、OS、Node.js・npmのバージョン、実行した操作、エラーの要点を、分かる項目だけ添えてください。
会社のコード、個人情報、パスワードや認証情報などは投稿しないでください。 公開できる範囲の説明だけで十分です。同じ内容をほかの場所にも報告している場合は、その旨も添えてください。
紹介した測定結果は制作者によるものです。第三者による実行、自分の環境への適用、継続利用は、現時点では未確認です。
現在は無料で試していただく段階です。有料版の内容・価格・開始日・販売方法は未定で、予約や決済は受け付けていません。
まずは今回のサンプルで、変更を比べて採用を判断する流れを試してもらえればと思います。実行できた点も、つまずいた点も、次にどんな題材や説明が必要かを考える材料にしていきます。