TypeScript

どのようなものか

TypeScriptは、JavaScriptに型注釈を加え、それを検査するコンパイラー
`tsc`を組み合わせた、Microsoftのプログラミング言語です。TSとも略さ
れ、ファイルの拡張子は`.ts`、JSXのマークアップを含む場合は`.tsx`で
す。JavaScriptの構文はTypeScriptでも有効なので、JavaScriptのスーパー
セットと呼ばれます。コンパイラーはApache
License 2.0の下で公開されているオープンソースです。

型が存在するのは、検査している間だけです。通常の型注釈は、TypeScript
がJavaScriptを出力するときに消去されます。実行時の検証を提供するもの
ではなく、実行時に型を検査するライブラリも必要としません。型注釈を加
えても、実行中のJavaScriptの動作は変わりません。この一点が、価値と限
界の両方を説明します。検査器が推論するのは、ソースコードに記述された
型についてであり、実行中に届くデータを検証するわけではありません。

型システムは構造的です。名前が何であっても、構造が合えば二つの型は互
換と見なされます。これは、単純なオブジェクトを受け渡すJavaScriptの使
い方に適しています。対して、C#やJavaは宣言された名前を比較します。型
の多くは推論されるため、注釈は主に関数のシグネチャや公開する値に付き
ます。また、型システムは一部で意図的に健全性を保証していません。
`any`はその値の検査を無効にし、`as`によるアサーションは、その型につ
いてプログラマーの申告を信じるようコンパイラーに指示します。どちら
も、ほかの型情報とともに出力から消えます。

実行方法は大きく三つあります。`tsc`はプロジェクトを検査して
JavaScriptを出力します。esbuildなどのバンドラーは、型を検査せずに取
り除き、検査は別に実行する`tsc
i--noEmit`に任せます。Node.jsはv23.6.0とv22.18.0以降、型の構文を空白		engineer.company	70
iで置き換えて`.ts`ファイルを直接実行します。この場合も型検査はせず、		engineer.company	70
iその方法で消去できる構文だけを受け入れます。2026年7月に発表された		engineer.company	70
iTypeScript		engineer.company	70
7.0は、Goで書かれたネイティブ版コンパイラーです。開発チームは、完全
なビルドでは通常8〜12倍速いと報告しています。

なぜ重要なのか

チームが判断するのは、実行前に誤りを見つけるために、ビルド工程と検査
器を追加するだけの価値があるかです。複数人が毎週変更するコードベース
では、たいてい価値があります。フィールド名を変えると、それを使ってい
た箇所がすべて分かり、エディターは型を基にコードを補完し説明します。
モジュールのシグネチャは、呼び出し側が気付かれずに破ることのできない
契約になります。代償は、ビルドごとの検査、多数の選択肢がある設定ファ
イル、そして対象ライブラリの変更に追従し続ける型定義です。

最も重要な設定は、検査の厳格さです。`strict`フラグは、
`strictNullChecks`や`noImplicitAny`など、一群の検査を有効にします。
ハンドブックは、その結果をスイッチではなく、段階を調整するダイヤルと
して説明しています。TypeScript
6.0以降、このフラグは既定で有効なので、新規プロジェクトは厳格な状態
から始まります。古いプロジェクトではfalseのままのこともあり、後から
有効にするには、影響するファイルを一つずつ確認し、対応する必要があり
ます。便利な二つの検査、`noUncheckedIndexedAccess`と
`exactOptionalPropertyTypes`は、この一群には含まれず、別に有効にしま
す。

型の消去が、保護の限界を決めます。ネットワーク要求、ファイル、
キュー、フォームからJSONを読むプログラムでは、そのデータの構造につい
て頼れるのはプログラマーの申告だけです。データが届く時点で、型は消え
ているからです。そのため、境界では実行時の検証が必要になります。検査
と型が食い違わないよう、理想的には型と同じ定義から生成します。
TypeScriptはプログラム内部の整合性を保ち、境界の扱いはコードに委ねま
す。

検査器は、ほかのツールにも情報を渡します。typescript-eslintなどのリ
ンターは、コンパイラーに型情報を問い合わせることで、誰も結果を待たな
いPromiseや、モジュール内に広がる`any`型の値を検出できます。チーム独
自の約束を、レビューの指摘ではなくエラーにする仕組みです。

実際の活用例

このサイトで紹介するプロジェクトでは、TypeScriptの信頼性を、慣習だけ
に頼らず、生成コードとツールで支えています。三つのページが、その方法
を示します。

あるプラットフォームでは、フロントエンドのTypeScriptクライアントを手
書きしません。API自身の記述から生成します。その記述はHumaがGoの型か
ら出力し、Goの型はデータベースのスキーマと関数に従います。記録された
実装段階で、クライアントは44,076行あり、同時に生成した61個のモックハ
ンドラーにより、フロントエンドのテストは手書きのフィクスチャではな
く、実際の契約に対して動きました。各段階に独自の検査があります。CIの
契約検査が、フロントエンドの送信内容とAPIが期待する内容を比較し、食
い違えばビルドを失敗させます。その下では、スキーマの検査処理が実際の
構造を調べます。欠落とnullを混同しやすい省略可能なリクエスト本文の
フィールドや、クエリーパラメーターの列挙値も対象です。片側でフィール
ドが変わると、不一致を出荷した後でブラウザーに422が現れるのではな
く、変更から数分でビルドが失敗します。代わりに、契約の変更をクライア
ントの型へ反映するには、連鎖をもう一度実行する必要があり、再生成には
手間がかかります。

別のページは、TypeScriptを含む六つの言語に、同じ基準を設けています。
ESLintの診断はすべてエラーで、警告扱いにして逃がす段階はありません。
コード内での抑制も禁止するため、指摘は黙らせるのではなく直す必要があ
ります。コミット前とプッシュ前のフックがリンターとテストを実行し、関
数とファイルの長さの上限が、モジュールの読みやすさを保ちます。

言語に付属するリンターだけでは、プロジェクト固有の規則まで扱えませ
ん。そこで、記録された実装段階では、十五個の独自ESLintルールが、その
リポジトリのTypeScriptの書き方を守っていました。これは274本の検査ス
クリプトからなる仕組みの一部で、うち268本はコミットフックに登録され
ていました。検査自体にも146件のテストがありました。検査が壊れると、
誰にも気付かれずにすべてを通してしまうからです。型ではなくテストを扱
うルールもあります。`fix:`で始まるコミットには、その修正がなければ失
敗するテストが必要です。レビュー時間は機械的な確認から設計へ移り、代
わりにコミットは遅くなりました。

問題が起きるところ

TypeScriptの失敗の多くは、コンパイラーから見える範囲を超えて型を信じ
ることから生じます。

文字列型のフィールドが、実行時にはundefinedだった。
データはプログラムの外から届き、検査する代わりに型を与えられていま
す。DOMライブラリは`res.json()`を`any`のPromiseとして型付けするた
め、結果をどう使ってもコンパイラーは受け入れます。アサーションは、そ
の信頼を明示するだけで、安全にはしません。

```ts
const res = await fetch("/api/user");
const user = (await res.json()) as User; // trusted, never checked
user.email.toLowerCase(); // TypeError if email is missing
```

外部データは`unknown`として扱い、境界で実行時にスキーマ検証を行い、
そのスキーマから型を生成して両者をそろえます。型情報を使うリンター
ルールなら、すり抜けた`any`も検出できます。

型エラーがあるコードが、そのまま本番へ届く。
`tsc`はエラーを報告してもJavaScriptを書き出します。`noEmitOnError`の
既定値がfalseだからです。バンドラーとNode.jsは、型をまったく検査せず
に消去します。CIとコミット前フックで`tsc
i--noEmit`を必須工程にし、その終了コードに従ってビルドを失敗させま		engineer.company	70
iす。		engineer.company	70

インデックスによる参照で、型が除外していたundefinedが返る。
配列要素やインデックスシグネチャを通じたキーの読み取りは、配列の末尾
を越えていても、常に値があるものとして型付けされます。
`noUncheckedIndexedAccess`を有効にすると、その読み取りに`undefined`
が加わり、コードでの対処が必要になります。
`exactOptionalPropertyTypes`と組み合わせると、プロパティが欠落してい
る場合と、値が`undefined`である場合を区別できます。

tscでコンパイルできたファイルが、Node.jsでは失敗する。
型の除去で消えるのは、実行時の意味を持たない構文だけです。値を持つ列
挙型や名前空間は、Node.jsを`ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX`で停止
させます。`type`キーワードなしにインポートした型は、値のインポートと
して扱われ、実行時に失敗します。`erasableSyntaxOnly`と
`verbatimModuleSyntax`を有効にして、Node.jsで動かす前にコンパイラー
で両方を検出し、型には`import
type`を使います。列挙型は、`as const`を付けたオブジェクトリテラルに
置き換えます。

参考資料

  * TypeScriptドキュメント — TypeScriptチームが保守するハンドブッ
ク、リファレンス、リリースノートです。

  * 基本事項 — 静的検査、エラーがある場合の出力、型の消去、検査の厳
格さを扱うハンドブックの章です。

  * TSConfigリファレンス：strict —
コンパイラーの各オプションと既定値、strictフラグが有効にする検査を説
明しています。

  * 型の互換性 — 構造的サブタイピングと、型システムが意図的に健全性
を保証しない箇所を扱います。

  * Node.js：モジュール：TypeScript — 型の除去、拒否する構文、
Node.jsが推奨するコンパイラー設定です。

  * 型情報を使うリント —
typescript-eslintが、リンタールールに型検査器へのアクセスを提供する
仕組みを説明しています。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/typescript/	engineer.company	70
