/appbirdNotebook-public/ts-mochaのざっくりとしたしくみ

generated at 2/16/2025, 5:30:34 PM
ts-mochaのざっくりとしたしくみ
from ts-mochaを使うとECMAScript moduleに依存したファイルでTypeError ERR_UNKNOWN_FILE_EXTENSION: Unknown file extension ".ts"が出てくる。
ts-mochaのざっくりとしたしくみ
 ts-mocha を叩いただけでどうしてtypescriptコードのままテストができるのか？

 ts-mocha コマンドのエントリポイントは/bin/ts-mocha(javascriptコード)にあり！
(1) package.jsonをのぞいてみるとbinにこのファイルが設定されていた。
つまり、ts-mochaというコマンドを打つと、 /bin/ts-mohca というコマンドが実行されることになる。
(2) /bin/ts-mochaの上部には、node.jsのShebangがついている。
つまり、このファイルをコマンドとして叩けば、ファイルの内容をnode.jsのコードとして実行してくれるということ。

 /bin/ts-mocha の中で呼び出しているコマンドは簡略化して表記すると、
 mocha --require /src/index.js ...(ts-mochaに渡した他のパラメタ)  
ここでは、 / はプロジェクトディレクトリを表している。
 --require とは何か？
--requireオプションの仕様
テストを実行する前に、渡されたファイルをモジュールとしてimport(require)する。
中に書いてあるコードもしっかり実行される。

 /src/index.js では ts-node を呼び出し、typescriptコードを実行している。
ts-mochaの/src/index.jsとは何か？
 --require を通して環境変数として渡される以下のパラメタをもとに、 ts-node を実行する
projectへのパス
transpileOnly: コンパイルだけするか否か(？)のフラグ
さらに、以下のコードがその中にあった(抜粋)
tsrequire('ts-node').register({
    project,
    transpileOnly,
});
> Create a new TypeScript compiler instance and register it onto node.js
> register -- ts-node API reference
この文におけるregisterがよくわかってない
おそらくどこかのタイミングで実行されるのだと考えられる...？
ts-nodeのregisterの実装 -- github TypeStrong
このコードによってコンパイルが実行されている。
RegisterOptions.project -- ts-node API reference
RegisterOptions.transpileOnly -- ts-node API reference
 ts-node/register と似た作用を持ってる...？

まとめ
内部で mocha を起動し、そのrequireオプションにts-nodeを実行するスクリプトを結びつけている。
重要なオプション引数以外はそのまま渡している。

メモ書き
--require module -- Node.js CLI Reference
> Only CommonJS modules are supported. Use --import to preload an ECMAScript module.