accurate-environment-model

環境を正確にモデル化する

概要

TypeScript の環境には、グローバル変数、環境変数、プラットフォーム固有の API が含まれます。宣言ファイル（.d.ts）を使って、環境の型定義を正確に作成します。これにより、プラットフォーム固有のコードやグローバル変数の型安全性が確保されます。

このスキルを使用する場面

• グローバル型を定義する
• window または globalThis を拡張する
• 環境変数に型を付ける
• ビルド時定数を扱う
• 型定義を設定する

厳守すべきルール

.d.ts ファイルを使って環境を正確にモデル化します。コードが依存するグローバル変数、window のプロパティ、環境変数を宣言します。

例

// types/environment.d.ts
declare global {
  interface Window {
    APP_CONFIG: {
      apiUrl: string;
      version: string;
    };
  }
  
  const BUILD_TIMESTAMP: number;
}

// Usage
console.log(window.APP_CONFIG.apiUrl);
console.log(BUILD_TIMESTAMP);

参考資料

• Dan Vanderkam 著『Effective TypeScript』第 2 版
• 項目 76：環境を正確にモデル化する