TypeScript「'e' is of type 'unknown'」が catch で出る原因と直し方
catch の 'e' is of type 'unknown'(TS18046)は、instanceof などで e を絞れば消える。
TS 4.8 以前は Object is of type 'unknown' と表示された。
公開: 更新:
npx tsc src/bad.ts(8,17): error TS18046: 'e' is of type 'unknown'.
npx tsc
2026-10-26 に node:20(TypeScript 5.9.3 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細
要約
catch (e) の中で e.message のように書くと、error TS18046: 'e' is of type 'unknown'.(e の部分は変数名)が出る。
これは TypeScript 4.4 以降の useUnknownInCatchVariables(strict: true で既定有効)によって、catch の変数が any ではなく unknown 型になったためである。unknown はそのままではプロパティを読めないので、型を絞ってから 使う。
安全側に倒した正しい挙動なので、握り潰さず対処する。
エラー文言はバージョンで変わる。
TypeScript 4.8 以前は、同じコードでerror TS2571: Object is of type 'unknown'.と表示されていた。
TypeScript 4.9 で、対象がeやobj.propのような名前で書ける式なら、その名前を入れたTS18046: '{名前}' is of type 'unknown'.を出すように変わった(microsoft/TypeScript#49797(新しいタブで開く))。
現行版でも、getError().messageのように名前で書けない式(関数呼び出しの結果など)ではTS2571: Object is of type 'unknown'.のままである。
どちらもunknownを絞っていないことが原因で、対処は同じである。
この記事下部の「## 実行例」は TypeScript 5.9 での実測のためTS18046を記録している。
実行例
node:20 のコンテナで TypeScript 5.9.3 の tsc を strict 有効で回すと、catch (e) 内の e.message に TS18046: 'e' is of type 'unknown'. が出て終了コード 2 になった。instanceof Error で絞った版と型ガード関数で絞った版は、どちらもエラーなしの終了コード 0 で通った。
Version 5.9.3$ npx tsc
src/bad.ts(8,17): error TS18046: 'e' is of type 'unknown'.
$ echo $?
2$ npx tsc
$ echo $?
0$ npx tsc
$ echo $?
0— 2026-10-26 時点の出力
検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-26 検証(ほか 2 件)
- 検証日
- 実行環境
node:20Debian GNU/Linux 12 (bookworm)- バージョン
- Node.js 20.20.2
- npm 10.8.2
- Python 3.11.2
- Git 2.39.5
- TypeScript 5.9.3
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。
解決策
1. instanceof で絞る
try {
doWork();
} catch (e) {
if (e instanceof Error) {
console.error(e.message);
} else {
console.error(String(e));
}
}Error 以外が throw される可能性も String(e) で受ければ漏れない。
2. 型ガード関数で検証する
function hasMessage(e: unknown): e is { message: string } {
return typeof e === "object" && e !== null && "message" in e;
}
try {
doWork();
} catch (e) {
if (hasMessage(e)) console.error(e.message);
}e is { message: string } の述語型で、必要な形だけを安全に取り出す。
3. any の多用を避ける
個別に catch (e: any) と書くこともできるが、型安全をその場で捨てることになる。
例外処理こそ未知の値が来る場所なので、unknown を絞る方針を基本にする。
詳しい背景は TypeScript 4.4 リリースノート(新しいタブで開く) に書かれている。
4. 移行期だけ設定で戻す
{
"compilerOptions": {
"useUnknownInCatchVariables": false
}
}これは、大量の旧 catch を一度に直せないときの一時的な退避策である。
各オプションの意味は tsconfig の useUnknownInCatchVariables(新しいタブで開く) にある。
最終的には unknown を絞る形へ寄せる。
よくある原因
- strict を有効にしている。
strict: trueに連動してuseUnknownInCatchVariablesが有効になり、catchの変数がunknown型になる。 - ナローイングせずにアクセスしている。
catch (e) { console.log(e.message) }のように、直接プロパティを読んでいる。 - reject 値の型を決めつけている。
Promiseの reject やthrowされる値を、any前提のコードで扱っている。 - 旧コードを移行している。
TypeScript 4.4 より前に書かれた例外処理コードを、そのまま移している。