ツール
Jest
JavaScript / TypeScript で広く使われるテスティングフレームワーク。ESM 対応や TypeScript の transform 設定、jest.mock の巻き上げで「テストが動かない」に陥りやすい。
バージョン移行
メジャーバージョンを上げたときに動かなくなることを、旧版と新版で同じコマンドを打ち比べて確かめた。
Jest 29 → 30・変更点 8 つ
Jest を 29 から 30 に上げると動かなくなること
問題一覧(6)
Jest「Cannot use import statement outside a module」の原因と直し方
Cannot use import statement outside a module は、babel-jest か ts-jest で変換させれば直る。ESM のみの依存は transformIgnorePatterns で変換対象に含める。
更新: 2026-10-15、タグ: esm、transform、babel-jest
Jest「ReferenceError: document is not defined」の原因と直し方
document is not defined は、testEnvironment を jsdom にすれば直る。Jest 27 以降は既定が node のためだ。Jest 28 以降は jest-environment-jsdom も別途入れる。
更新: 2026-11-19、タグ: jsdom、testEnvironment、dom
Jest で「Exceeded timeout of 5000 ms for a test」が出てテストが完了できない
Exceeded timeout of 5000 ms は、終わらない非同期処理を直すか、タイムアウト値を延ばせば直る。resolve されない Promise や done の呼び忘れを先に疑う。
更新: 2026-11-05、タグ: timeout、testtimeout、async
Jest で path alias(@/)が解決できず Cannot find module になる
tsconfig.json の paths や bundler の alias は Jest には伝わらない。Jest は独自の解決器を使うため、jest.config の moduleNameMapper に同じ対応を書き写す必要がある。正規表現の後方参照と rootDir トークンで対応付ける。
更新: 2026-10-20、タグ: module-resolution、path-alias、modulenamemapper
Jest で TypeScript が「SyntaxError: Unexpected token」で実行できない
SyntaxError: Unexpected token は、ts-jest か @babel/preset-typescript で .ts を変換させれば直る。Jest 自体は TypeScript を理解しないためだ。
更新: 2026-10-11、タグ: typescript、ts-jest、transform
Jest「Option "testPathPattern" was replaced」の原因と直し方
Option "testPathPattern" was replaced は、--testPathPatterns に書き替えれば直る。Jest 30 でオプションの名前の末尾に s が付き、古い名前を渡すとテストを走らせずに止まる。
更新: 2026-11-16、タグ: jest30、testpathpatterns、cli