できない.dev

TypeScript「'e' is of type 'unknown'」が catch で出る原因と直し方

catch の 'e' is of type 'unknown'(TS18046)は、instanceof などで e を絞れば消える。
TS 4.8 以前は Object is of type 'unknown' と表示された。

公開: 更新:

症状できない · exit 2
npx tsc
src/bad.ts(8,17): error TS18046: 'e' is of type 'unknown'.
解決後できた · exit 0
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:20 Debian 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 を絞る形へ寄せる。

よくある原因

  1. strict を有効にしている。
    strict: true に連動して useUnknownInCatchVariables が有効になり、catch の変数が unknown 型になる。
  2. ナローイングせずにアクセスしている。
    catch (e) { console.log(e.message) } のように、直接プロパティを読んでいる。
  3. reject 値の型を決めつけている。
    Promise の reject や throw される値を、any 前提のコードで扱っている。
  4. 旧コードを移行している。
    TypeScript 4.4 より前に書かれた例外処理コードを、そのまま移している。