できない.dev

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 unit

Jest CLI Options(新しいタブで開く) によると、jest に渡した引数は、テストファイルのパスに当てる正規表現として扱われる。
29 と 30 のどちらでも同じように動くので、版の違うプロジェクトで同じ scripts を使うなら、この形にしておけば書き替えずに済む。

よくある原因

  1. コマンドに古い名前を書いている。
    Jest 29 では --testPathPattern で通っていたので、上げた直後にこのエラーで気づくことが多い。
  2. 打ったコマンドではなく、package.json の scripts や CI のワークフローに古い名前が残っている。
    npm test -- --testPathPattern=unit のように後ろへ渡す形でも同じである。
  3. Jest をプログラムから呼んでいる。
    公式の移行ガイド(新しいタブで開く)によると、Jest は渡したパターンを内部で TestPathPatterns というオブジェクトにまとめるようになった。
    watch モードに testPathPattern を渡していたコードは、このオブジェクトを作って渡す形に直す。