Jest「Option "testPathPattern" was replaced」の原因と直し方
Option "testPathPattern" was replaced は、--testPathPatterns に書き替えれば直る。
Jest 30 でオプションの名前の末尾に s が付き、古い名前を渡すとテストを走らせずに止まる。
公開:
要約
Jest 30 に上げたプロジェクトで npx jest --testPathPattern=unit を打つと、テストを 1 本も走らせずに止まる。
Option "testPathPattern" was replaced by "--testPathPatterns".Jest 30 から、テストファイルのパスを正規表現で絞り込むオプションの名前が --testPathPatterns に変わった。Option "testPathPattern" was replaced は、古い名前を渡したときに設定の検査で出るエラーである。
末尾に s を付けて --testPathPatterns と書けば直る。
解決策
1. オプションの名前を直す
npx jest --testPathPatterns=unit--testPathPatterns はパターンを空白で区切って複数渡せる。
オプションを繰り返して渡してもよい。
npx jest --testPathPatterns "unit/.*" "integration/.*"2. scripts と CI の設定を検索する
grep -rnE "testPathPattern([^s]|$)" package.json .github/見つかった行を --testPathPatterns に書き替える。
エラーの案内のとおり、--testPathPatterns はコマンドラインだけのオプションで、jest.config.js には書けない。
3. オプションを使わずに引数で渡す
npx jest unitJest CLI Options(新しいタブで開く) によると、jest に渡した引数は、テストファイルのパスに当てる正規表現として扱われる。
29 と 30 のどちらでも同じように動くので、版の違うプロジェクトで同じ scripts を使うなら、この形にしておけば書き替えずに済む。
よくある原因
- コマンドに古い名前を書いている。
Jest 29 では--testPathPatternで通っていたので、上げた直後にこのエラーで気づくことが多い。 - 打ったコマンドではなく、
package.jsonの scripts や CI のワークフローに古い名前が残っている。npm test -- --testPathPattern=unitのように後ろへ渡す形でも同じである。 - Jest をプログラムから呼んでいる。
公式の移行ガイド(新しいタブで開く)によると、Jest は渡したパターンを内部でTestPathPatternsというオブジェクトにまとめるようになった。
watch モードにtestPathPatternを渡していたコードは、このオブジェクトを作って渡す形に直す。