【ITニュース解説】TypeScript Is Unsound on Purpose: 7 Programs That Type-Check, Then Crash
2026年10月21日に「Dev.to」が公開したITニュース「TypeScript Is Unsound on Purpose: 7 Programs That Type-Check, Then Crash」について初心者にもわかりやすく解説しています。
ITニュース概要
TypeScriptは厳密な型チェックと生産性のバランスを取り、意図的に完全な型安全ではない。そのため、コンパイルが通っても実行時にエラーになる場合がある。配列の扱い方や型アサーションなど、いくつかの注意点とその対策を知り、安全なコード作成を心がけるべきだ。
ITニュース解説
TypeScriptは、JavaScriptに強力な型システムを導入し、開発者がコードの誤りを早期に発見できるよう支援するツールだ。しかし、その型システムは「完全に正しい」こと(健全性)を追求するのではなく、開発の生産性とのバランスを取るように設計されている。これは、コンパイル時に型チェックが成功したにもかかわらず、プログラムが実行時に型に関連するエラーでクラッシュする可能性があることを意味する。
TypeScriptの設計チームは、この「意図的な非健全性」を明言している。なぜなら、すべての可能性を厳密にチェックすると、既存のJavaScriptコードとの互換性が失われたり、型定義が複雑になりすぎたりして、かえって開発効率が落ちるからだ。そのため、特定の状況では、コンパイラは開発者の意図を「楽観的に」解釈し、実行時の安全性をプログラマに委ねることがある。
多くの開発者が利用する--strictフラグは、より厳格な型チェックを有効にするが、それでもすべての実行時エラーを防げるわけではない。以下に、--strictフラグが有効な環境でもコンパイルエラーにならず、実行時に問題を引き起こす可能性のある代表的な7つのケースと、その対策について説明する。
一つ目は、配列の共変性に関する問題だ。例えば、DogクラスがAnimalクラスを継承している場合、Dog型の配列(Dog[])をAnimal型の配列(Animal[])として扱うことができる。これは「共変性」と呼ばれ、配列の要素を「読み取る」際には安全で便利だ。しかし、このAnimal[]として扱われている配列に、Cat型のオブジェクト(これもAnimalを継承している)を追加できてしまうと、後でDog型の配列としてDog専用のメソッドを呼び出した際に、実際にはCat型のオブジェクトが混入しているため、実行時エラーになる。配列は読み取りでは共変だが、書き込みでは安全ではないため、書き込み操作をさせたくない場合は、パラメータをreadonly Animal[]のように読み取り専用の型として宣言する必要がある。
二つ目は、メソッドの双変性に関する問題だ。インターフェースでstring | number型の引数を受け取るメソッドが定義されていても、その実装で引数をstring型に絞り込んでしまうケースがある。通常、TypeScriptはこのような引数の型の不一致を検出するが、メソッド構文で定義されたメンバー(関数)の場合、TypeScriptは既存のJavaScriptライブラリとの互換性を保つために、チェックを緩める(「双変」に扱う)設計になっている。そのため、このメソッドにnumberを渡すと、実行時にstring専用のメソッドを呼び出そうとしてエラーになる。この問題を避けるには、メソッドではなくプロパティ構文(handle: (input: string | number) => voidのように定義)を使って関数を宣言すれば、より厳密な型チェックが適用される。
三つ目は、コールバック関数による型の絞り込みの破綻だ。あるオブジェクトのプロパティがnullではないと型を絞り込んだ後、そのプロパティを外部から変更する可能性のあるコールバック関数を呼び出すと、TypeScriptはコールバック関数がそのプロパティを変更しないと「楽観的に」判断する。結果として、コールバックがプロパティをnullに書き換えてもコンパイルエラーにならず、絞り込み後のコードが実行された際にnullに対してメソッドを呼び出し、実行時エラーになる。この状況を回避するには、コールバックを呼び出す前に、絞り込み済みのプロパティの値を一時的なconst変数にコピーして利用すると良い。const変数はコールバックからは変更できないため、安全性が保たれる。
四つ目は、存在しないキーへのアクセスだ。Record<string, number>のように、任意の文字列キーに対して数値が返されることを示す型を持つオブジェクトから、実際には存在しないキーでプロパティにアクセスすると、TypeScriptは「数値が返ってくるはず」と判断する。しかし、JavaScriptの仕様では存在しないプロパティにアクセスするとundefinedが返るため、undefinedに対して数値のメソッドを呼び出し、実行時エラーになる。この問題を防ぐには、tsconfig.jsonでnoUncheckedIndexedAccessフラグを有効にすると良い。これにより、インデックスアクセスや配列の読み取り結果にundefinedが含まれる可能性が型として明示され、開発者は実行時エラーを未然に防ぐチェックを強制される。
五つ目は、オプショナルプロパティの情報が失われるケースだ。データが豊富なオブジェクトを、いったんプロパティが少ない(狭い)インターフェースに代入し、その後、元のオブジェクトが持っていたオプショナルプロパティを含む(広い)インターフェースに代入し直すと、中間の代入の段階でコンパイラがオプショナルプロパティに関する情報を見失うことがある。結果として、実行時にオプショナルプロパティが期待する型と異なる値(例えば文字列)を持っていても、型チェックをすり抜けてしまい、その値に対して数値のメソッドなどを呼び出し実行時エラーになる。この問題は、外部から入力されるデータをプログラムの境界(例えばAPIの受信時)で厳密に検証し、信頼できる状態にしてから内部で利用することで防げる。
六つ目は、型アサーションの過信だ。asキーワードを使って変数を特定の型に「型アサーション」することは、開発者がコンパイラに対して「この変数はこの型であると私が保証する」と伝える行為だ。しかし、型アサーションはコンパイル時にのみ有効であり、実行時には一切のチェックが行われない。もしアサーションが誤っていた場合、例えば存在しないプロパティにアクセスしようとすると、実行時にエラーとなる。安全なコードを書くためには、Zodのようなスキーマバリデーターライブラリを使うか、独自のランタイムチェック関数を用意し、実行時にも型が正しいことを検証するべきだ。
七つ目は、偽りの型ガードだ。pet is Catのように、引数が特定の型であることを宣言する「型ガード関数」は、その実装内容に関わらず、コンパイラは開発者が宣言した型を信頼してしまう。例えば、Cat型かどうかを判定するはずの関数が、誤ってDog型を判定するロジックになっていても、コンパイラはそれを問題なく受け入れてしまう。そのため、ガード関数のロジックが間違っていると、Dog型のオブジェクトをCat型として扱い、存在しないメソッドを呼び出すなどの実行時エラーにつながる。この問題への対策として、TypeScript 5.5以降では、特定の条件下でコンパイラが型ガード関数の本体から型述語を「推論」できるようになり、誤った宣言を防げるようになった。また、明示的な型ガードを利用する場合は、そのロジックを単体テストで厳密に検証することが非常に重要だ。
これらのケースは、TypeScriptが完全に完璧な型システムではないことを示している。しかし、これはTypeScriptの欠点というよりは、開発の現実世界における複雑さや既存のJavaScriptとの互換性を考慮した上での、意図的な設計判断である。TypeScriptを効果的に使うためには、その限界を理解し、noUncheckedIndexedAccessのような厳格なコンパイラフラグを有効にする、ランタイムでのデータ検証を導入する、readonly修飾子を適切に使う、そして単体テストで型ガードのロジックを検証するなど、複数のアプローチを組み合わせて利用することが不可欠だ。TypeScriptは多くの間違いを防いでくれる強力なツールだが、最終的なプログラムの安全性は開発者の理解と注意深いコーディングによって保証される。