型定義ファイル(.d.ts)と@types
JavaScriptで書かれたライブラリをTypeScriptから使うとき、型情報が必要です。型定義ファイル(.d.ts)がその橋渡しをします。
学習者ライブラリを入れたら「型定義が見つかりません」って怒られた…。@types/... って何者なの?
扱うトピック
.d.tsファイルとは
型情報だけを記述したファイル。実装コードは含まない。TypeScriptコンパイラはこのファイルを見て型チェックを行う。
@types パッケージ
npm install --save-dev @types/react @types/nodeDefinitelyTypedリポジトリでコミュニティが管理する型定義パッケージの仕組みを解説予定です。
型定義が同梱されているライブラリ
axios、zod、date-fns など、ライブラリ本体に .d.ts が含まれているケース。@types が不要な場合の見分け方を解説予定です。
型定義がないライブラリへの対処
declare module で最低限の型定義を書く方法を解説予定です。
グローバル型定義
global.d.ts でプロジェクト全体の型を拡張する方法を解説予定です。
この章の詳細な内容は順次追加していきます。