宣言とマージ

型宣言ファイル (.d.ts 拡張子付き) は、実際のロジックを実装せずに、既存の JavaScript コードの形状を記述するために TypeScript で使用されます。これらには、型定義、インターフェイス、および関数シグネチャのみが含まれます。

これらのファイルは、純粋な JavaScript で記述されたサードパーティ ライブラリを使用する場合に不可欠です。

宣言のマージ

宣言のマージ は、コンパイラが同じ名前で宣言された 2 つ以上の別々の宣言を 1 つの定義にマージする動作です。

最も一般的なケースは インターフェイス のマージです。

interface User {
  name: string;
}

interface User {
  age: number;
}

// The resulting User interface has both name and age properties!
const student: User = {
  name: 'Alice',
  age: 23,
};

プロパティが同じ名前を共有する場合、それらは同じ型である必要があります。そうでない場合、TypeScript はエラーを報告します。

グローバルモジュールと外部モジュールの変更

宣言のマージを使用して、他のモジュールまたはグローバル スコープで定義されたインターフェイスを拡張できます。

たとえば、ブラウザのグローバル window オブジェクトにプロパティを追加する場合は、次のようにします。

declare global {
  interface Window {
    analyticsToken: string;
  }
}

declare global を使用することで、既存のグローバル Window インターフェイスに新しい署名を挿入していることを TypeScript に伝えます。

自分で試してみてください

演習 1: 基本的な宣言のマージ

演習 2: グローバル ウィンドウ インターフェイスの拡張