できない.dev

ts-node「reading 'fileExists'」が TypeScript 7 で出る原因と直し方

ts-node の (reading 'fileExists') という TypeError は、typescript@7 で起動すると出る。
7.0 に ts-node が使う API が無いためで、Node.js 24 で直接動かすか、tsx に替えるか、6.0 を割り当てれば直る。

公開:

症状できない · exit 1
npx ts-node hello.ts
…
TypeError: Cannot read properties of undefined (reading 'fileExists')
    at readConfig (/tmp/tmp.5l8RXnqMDz/node_modules/ts-node/dist/configuration.js:91:33)
    at findAndReadConfig (/tmp/tmp.5l8RXnqMDz/node_modules/ts-node/dist/configuration.js:50:84)
    at phase3 (/tmp/tmp.5l8RXnqMDz/node_modules/ts-node/dist/bin.js:254:67)
解決後できた · exit 0
npx ts-node hello.ts
hello, dekinai

2026-11-06 に node:24(TypeScript 7.0.2 / Node.js 24.22.2) で実際に打って取った出力。検証環境の詳細

要約

TypeError: Cannot read properties of undefined (reading 'fileExists') は、typescript@7 を入れたプロジェクトで npx ts-node を打つと出るエラーだ。
落ちる場所は ts-node/dist/configuration.js の readConfig である。
ts-node は require("typescript") で読んだ API を使って .ts を変換するが、7.0 の typescript パッケージは版の番号しか返さない。
ts-node が最初に読む ts.sys が undefined なので、その fileExists を読んだところで落ちる。

直し方は、型の検査を ts-node に任せていたかどうかで選ぶ。
動かすだけなら Node.js か tsx に替え、ts-node を残すなら 6.0 の API を割り当てる。

実行例

node:24 のコンテナで typescript 7.0.2 と ts-node 10.9.2 を入れ、npx ts-node hello.ts を打つと TypeError で終了コード 1 になった。
同じファイルは node・tsx・6.0 を割り当てた ts-node のどれでも動いた。

$ cat hello.ts
const site: string = "dekinai";
console.log(`hello, ${site}`);
$ npx ts-node hello.ts
/tmp/tmp.5l8RXnqMDz/node_modules/ts-node/dist/configuration.js:91
    const { fileExists = ts.sys.fileExists, readFile = ts.sys.readFile, skipProject = index_1.DEFAULTS.skipProject, project = index_1.DEFAULTS.project, tsTrace = index_1.DEFAULTS.tsTrace, } = rawApiOptions;
                                ^
 
TypeError: Cannot read properties of undefined (reading 'fileExists')
    at readConfig (/tmp/tmp.5l8RXnqMDz/node_modules/ts-node/dist/configuration.js:91:33)
    at findAndReadConfig (/tmp/tmp.5l8RXnqMDz/node_modules/ts-node/dist/configuration.js:50:84)
    at phase3 (/tmp/tmp.5l8RXnqMDz/node_modules/ts-node/dist/bin.js:254:67)
    at bootstrap (/tmp/tmp.5l8RXnqMDz/node_modules/ts-node/dist/bin.js:47:30)
    at main (/tmp/tmp.5l8RXnqMDz/node_modules/ts-node/dist/bin.js:33:12)
    at Object.<anonymous> (/tmp/tmp.5l8RXnqMDz/node_modules/ts-node/dist/bin.js:579:5)
    at Module._compile (node:internal/modules/cjs/loader:1929:14)
    at Object..js (node:internal/modules/cjs/loader:2060:10)
    at Module.load (node:internal/modules/cjs/loader:1651:32)
    at Module._load (node:internal/modules/cjs/loader:1443:12)
 
Node.js v24.22.2
$ echo $?
1
$ node -e 'const ts = require("typescript"); console.log(ts.version, typeof ts.sys)'
7.0.2 undefined
$ node hello.ts
hello, dekinai
$ echo $?
0
$ npx tsx hello.ts
hello, dekinai
$ echo $?
0
$ npm install -D "typescript@npm:@typescript/typescript6@^6.0.2" "@typescript/native@npm:typescript@^7.0.2" ts-node@10 @types/node@24
added 23 packages in 1s
$ echo $?
0
$ npx ts-node hello.ts
hello, dekinai
$ echo $?
0

— 2026-11-06 時点の出力

検証環境Node.js 24.22.2 / npm 11.19.1 / Python 3.11.2 / 2026-11-06 検証(ほか 2 件)
検証日
実行環境
node:24 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 24.22.2
  • npm 11.19.1
  • Python 3.11.2
  • Git 2.39.5
  • TypeScript 7.0.2

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. Node.js 24 で直接動かす

node hello.ts

Node.js 24 は .ts のファイルをそのまま実行できる(Node.js の TypeScript のページ(新しいタブで開く))。
型の注釈を取り除いて動かすだけなので、型の誤りがあってもそのまま走る。
型は npx tsc --noEmit で別に検査する。
enum のように実行時のコードが要る構文は取り除けず、ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX で止まる。

2. tsx に替える

npm install -D tsx
npx tsx hello.ts

tsx は esbuild で変換するので、TypeScript の API を使わない。
こちらも型は検査しない。

3. ts-node を残して typescript に 6.0 を割り当てる

型を検査しながら動かす ts-node の挙動が要るなら、npm のエイリアスで 6.0 と 7.0 を同じプロジェクトに入れる(TypeScript 7.0 の告知(新しいタブで開く)の方法)。

npm install -D "typescript@npm:@typescript/typescript6@^6.0.2" "@typescript/native@npm:typescript@^7.0.2"

ts-node は typescript という名前で入った 6.0 を読み、npx tsc は 7.0 を動かす。

よくある原因

  1. typescript を 7 に上げた。
    npm install -D typescript で入る最新版は 7.0 系で、ts-node 10.9.2 は 7.0 の上では起動できない。