TypeScript を採用する理由

TypeScriptは、JavaScriptに「型」の情報を加えたプログラミング言語です。型とは、ある変数が文字なのか数値なのか、どんな項目を持つデータなのかを事前に宣言する仕組みで、書いたコードは最終的に通常のJavaScriptに変換されてブラウザやNode.jsで動きます。型があることで、項目名の打ち間違いやデータ形式の食い違いといった誤りを、実行する前の段階で検出できます。エディタの補完や参照の追跡も正確になるため、規模の大きなプロジェクトや複数人での開発で特に効果を発揮します。

弊社では、JavaScriptで書く部分は原則としてTypeScriptで記述しています。Next.jsやReactで作る画面、FastifyなどNode.jsで作るサーバー、AWS CDKによるインフラ構成の記述まで、同じ言語で通せることが大きな理由です。業務システムでは、APIがやり取りするデータの形をOpenAPIの仕様から型として自動生成し、画面側の入力チェックにはzodを使って型と検証ルールを一致させています。これにより、サーバー側の仕様変更が画面側のどこに影響するかを、コードを実行せずに把握できます。要件定義で決めた項目やルールが型として残るため、設計資料とコードのずれが起きにくく、担当者が変わったときの読み解きも楽になります。長く使う業務システムほど、型による安全性が保守コストの削減につながると考えています。

TypeScript本体の更新では、型チェックが厳しくなり、これまで通っていたコードが警告や誤りとして検出されることがあります。これは潜在的な問題が見つかったと捉え、更新時に一つずつ対処します。周辺ライブラリが提供する型定義の更新も影響するため、依存関係をまとめて更新する時期を決め、ステージング環境で型チェックとビルドが通ることを確認してから本番に反映します。型チェックとテストを継続的インテグレーションで自動実行しておくと、更新の影響を早い段階で把握できます。