ts-loaderのビルドエラーで詰まったメモ

last update: 2024/09/09

背景

テスト用ライブラリ（jestだとか、testing-libraryだとか）の更新作業を行なった際に、意図しないビルドエラーが発生した。

テスト用のライブラリしか更新していないはずなのになぜ？？というところから調査スタート。

実際に更新したバージョン

以下のライブラリ更新を実施。

発生したエラー

以下が実際に発生したエラー。

ERROR in ./src/index.tsx
#12 4.479 Module build failed (from ./node_modules/ts-loader/index.js):
#12 4.479 Error: Debug Failure. False expression: Non-string value passed to `ts.resolveTypeReferenceDirective`, 
likely by a wrapping package working with an outdated `resolveTypeReferenceDirectives` signature. 
This is probably not a problem in TS itself.
#12 4.479     at Object.resolveTypeReferenceDirective (/node_modules/typescript/lib/typescript.js:43500:18)

重要なのは以下の部分。

#12 4.479 Error: Debug Failure. False expression: Non-string value passed to `ts.resolveTypeReferenceDirective`, 
likely by a wrapping package working with an outdated `resolveTypeReferenceDirectives` signature.
 This is probably not a problem in TS itself.

意味的には「TypeReferenceDirectiveを解決しようとするモジュールに古いものがあるんじゃね？多分TypeScript自体は悪くないよ。」という感じ。だと思ってる。

とりあえずエラーの解決方法を探す

TypeReferenceDirectiveとは何かを調べた。

一旦詳細は省くが、おそらくコレのこと。

これ自体が悪さをしているわけではないが、これを解決する何らかのライブラリが、typescriptのバージョンをサポートできない程度に古いことが悪さをしている可能性が高そう。

ただ、今回更新したライブラリにそれらしいものはない。。。

という認識だが、ライブラリを更新した際に何らかの依存関係があるライブラリが更新されてしまっているのでは？

yarn.lockファイルを眺めて依存関係の更新を調べる

yarn.lockって何ーってのはこの辺りの記事がわかりやすかった。

package-lock.jsonとyarn.lockの存在理由

とはいえyarn.lockを調べるにしても数万行のものを虱潰しに調べているのでは時間がいくらあっても足りんので、仮説を立てて調べる。

> これ自体が悪さをしているわけではないが、これを解決する何らかのライブラリが、Typescriptのバージョンをサポートできない程度に古いことが悪さをしている可能性が高そう。

と書いたが、もしかするとTypescriptのバージョンが勝手に更新されて、それを解決しようとするライブラリのバージョンが追いついていない可能性がある？という仮説で調査。

調査したところ、yarn.lockの記述ではTypescriptのバージョンが`v4.5.4`から`v4.9.5`に更新されていることを確認。

package.jsonに記載しているバージョンは`^4.0.4`という感じで、v4の中であれば依存関係に合わせて自動的にバージョンを更新するようになっていたので気づけなかった。

ライブラリのリリースノートを調べる

てわけでTypeScriptのバージョンが勝手に変わっていることに原因がありそうなので、TypeScriptのリリースノートを調査する。

リリースノートも情報に溢れているので、「TypeReferenceDirective」、「reference」、「directive」あたりをキーワードにして調査。

調査したところ、v4.7のリリースノートに気になる記述を発見。

従来からあったTripleSlashDirectiveでパッケージを参照する際に、その解決方法を明示できるようになった？感じと解釈。

超あやふやだが、一旦重要なのは「typescriptのv4.7にて今回のエラーに関わっていそうな変更が加わっている」かつ、「今回のtypescriptのバージョン更新差分には、このv4.7が含まれている」ということ。

原因ぽいライブラリのバージョン固定

てわけでtypescriptのバージョンが原因くさいので、一度バージョンを勝手に更新されないようにresolutionで固定する。

  ...
  },
  "resolutions": {
    "typescript": "4.5.4"
  }

この状態でパッケージを再度インストールしなおしたところ、ビルドが通るようになった。

根本解決をしたい

ただ、これだとtypescriptのバージョンが今後もずっとv4.5.4で固定されるままだし、またバージョン更新を行おうとする際に同じ目に遭う予感。

元々エラーメッセージにも「TypeScriptが原因ではない」とあったので、再度別路線で調査を行う。

TypeScriptに依存していそうなパッケージを探す

本来依存関係のあるパッケージは勝手にバージョンが更新されるものだが、メジャーバージョンを跨ぐようなケースについては自動更新がされないようになっているので、この辺りで更新漏れのパッケージが発生している予感。

というわけで目をつけたのが「ts-loader」というパッケージ。

というのも、「resolveTypeReferenceDirective」と検索をかけると大概「ts-node」か「ts-loader」についての記事ばかり見つかるため。

そのうち、ts-loaderについてはpackage.jsonにバージョンを明示していたので。

ts-loaderのリリースノートを調べる

TypeScriptほど膨大ではないが、とはいえやはりリリースノートは情報の多い場所なので、こちらもヤマを張って調べる。TypeScriptに関係している箇所を調べるので「TypeScript」や「typeReferenceDirective」でページ内検索をかけて調査。

で、調査した結果関係していそうなリリースノートを発見。

> fix: cater for change in resolveTypeReferenceDirective API in 4.7

と記載があり、明確にv4.7に追従する変更を加えたとの記載がある。

ts-loaderのバージョンを変更してみる

というわけでTypeScriptのバージョン固定は外し、ts-loaderのバージョン変更を実施。

結果、v8.3.0未満ではビルドが落ちるが、v8.4.0にするとビルドが通ることを確認。

調査結果のまとめ

根本原因

対応

今回の調査で分かったこと

おわり。