ツール
Vitest
Vite のパイプラインをそのまま使うユニットテストフレームワーク。Jest 互換 API を持ちつつ ESM / TypeScript / JSX をビルド設定なしで実行できる。設定の指定漏れや vi.mock のホイスティングで詰まりやすい。
バージョン移行
メジャーバージョンを上げたときに動かなくなることを、旧版と新版で同じコマンドを打ち比べて確かめた。
Vitest 4 → 5・変更点 8 つ
Vitest を 4 から 5 に上げると動かなくなることVitest 3 → 4・変更点 10 つ
Vitest を 3 から 4 に上げると動かなくなること
問題一覧(11)
Vitest「bench is not a function」の原因と直し方
Vitest 5 の bench is not a function は、test で包み、引数から受け取った bench を使えば直る。bench は vitest から import できなくなった。
更新: 2026-11-07、タグ: bench、benchmark、typeerror
Vitest 5「expected "vi.fn()" to be called」の原因と直し方
Vitest 5 で expected "vi.fn()" to be called が出たら、clearMocks: false に戻すか、呼び出しを beforeEach で起こせば直る。5 で clearMocks が既定で有効になった。
更新: 2026-11-07、タグ: clearmocks、vi-fn、mock
Vitest「describe is not defined」の原因と直し方
describe is not defined は、test.globals を true にするか vitest から import すれば直る。Vitest は既定で describe / it / expect をグローバルに公開しない。
更新: 2026-11-01、タグ: globals、config
Vitest「describe.sequential is not a function」の原因と直し方
describe.sequential is not a function は、Vitest 5 で無くなった describe.sequential を呼ぶと出る。第 2 引数に { concurrent: false } を渡せば直る。
更新: 2026-11-07、タグ: sequential、concurrent、typeerror
Vitest「document is not defined」の原因と直し方
document is not defined は、Vitest の test.environment を jsdom か happy-dom にすれば直る。既定の環境は node で、DOM API を持たないためだ。
更新: 2026-09-17、タグ: jsdom、environment
Vitest で「No test files found, exiting with code 1」が出てテストを実行できない
No test files found, exiting with code 1 は、テストファイルが 0 件だと出る。ファイル名に .test か .spec を付けるか、include や絞り込みの文字列を直せば直る。
更新: 2026-10-30、タグ: include、test-files、filter
Vitest「Cannot find package '@/…'」がパスエイリアスで出る原因と直し方
Vitest の Cannot find package '@/foo' は、@/ を resolve.alias に定義すれば直る。tsconfig の paths は Vitest の実行時のモジュール解決には使われない。
更新: 2026-11-19、タグ: alias、vite、tsconfig-paths
Vitest「Promise returned by … was not awaited」の原因と直し方
Promise returned by … was not awaited は、Vitest 5 で await していない resolves や rejects があると出る。expect に await を付けるか return すれば直る。
更新: 2026-11-07、タグ: resolves、rejects、async
Vitest で -t で絞り込んだテストが実行されない
Vitest で -t を付けたテストが全部 skipped になるなら、describe とテストの名前を「 > 」でつなげば直る。5 は -t を「math > adds」の形の名前と照合し、当たらなくても終了コードは 0 だ。
更新: 2026-11-07、タグ: test-name-pattern、filter、exit-code
Vitest の vi.mock が効かない(巻き上げと factory のスコープ)
vi.mock はファイル先頭へ巻き上げられて import より前に実行されるため、外側スコープの変数を factory 内で参照すると失敗する。vi.hoisted を使うか、巻き上げない vi.doMock に切り替えると解決する。
更新: 2026-10-02、タグ: vi-mock、mock、hoisting
Vitest「test.poolOptions was removed in Vitest 4」の原因と直し方
Vitest 4 の test.poolOptions was removed in Vitest 4 は、中身を test の直下に移せば直る。4 は警告を出すだけで poolOptions を読まず、execArgv などが効かないままテストが走る。
更新: 2026-11-18、タグ: vitest4、pool-options、config