Node.js で TypeScript を設定して使用する方法

TypeScript は、JavaScript の静的型付けスーパーセットであり、言語に型の安全性やその他の機能を追加します。TypeScript を Node.js で使用すると、ツール、型チェック、保守性が向上し、開発が強化されます。このガイドでは、Node.js プロジェクトで TypeScript を設定して使用する手順について説明します。

前提条件

Node.js を使用して TypeScript を設定する前に、Node.js と npm (Node Package Manager) がシステムにインストールされていることを確認してください。これらのツールは、プロジェクトの依存関係を管理し、スクリプトを実行するために不可欠です。

TypeScript の設定

TypeScript を Node.js プロジェクトに統合するには、次の手順に従います。

新しい Node.js プロジェクトを初期化する: まず、新しいディレクトリを作成し、npm を使用して Node.js プロジェクトを初期化します。

mkdir my-project
cd my-project
npm init -y

TypeScript をインストールします: npm を使用して、開発依存関係として TypeScript をインストールします。

npm install typescript --save-dev

TypeScript 構成のセットアップ: tsconfig.json という名前の TypeScript 構成ファイルを作成します。このファイルは、コンパイラオプションとプロジェクト設定を指定します。

npx tsc --init

Node.js プロジェクトの基本構成は次のとおりです。

{
  "compilerOptions": {
    "target": "ES6",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

TypeScript ファイルを作成します:src ディレクトリに TypeScript ファイルを追加します。例として、簡単な TypeScript ファイルを作成します。

// src/index.ts
function greet(name: string): string {
  return `Hello, ${name}!`;
}

console.log(greet("World"));

TypeScript コードをコンパイルする: TypeScript コンパイラを使用して TypeScript ファイルを JavaScript にコンパイルします。

npx tsc

コンパイルされた JavaScript ファイルは、tsconfig.json ファイルで指定された dist ディレクトリに出力されます。

コンパイルされたコードを実行します: Node.js を使用して、コンパイルされた JavaScript ファイルを実行します。

node dist/index.js

追加のヒント

型定義: Node.js ライブラリでの型サポートを向上させるには、npm を使用して DefinitelyTyped から型定義をインストールします。たとえば、Node.js の型定義を追加するには、npm install @types/node --save-dev を実行します。
Node.js フレームワークを使用した TypeScript: Express などのフレームワークで TypeScript を使用する場合は、フレームワーク固有の機能の型の安全性を有効にするために、対応する型定義をインストールして構成してください。

結論

Node.js で TypeScript を設定すると、静的型付けと高度な機能を活用して、コードの品質と開発者の生産性が向上します。ここで説明する手順に従うことで、TypeScript 環境を Node.js プロジェクトに効果的に統合し、より堅牢で保守しやすいコードを作成できます。

typescript ノードセットアップ構成コンパイラプロジェクトインストールコードコンパイル実行依存関係タイプモジュール